components:
  schemas:
    ErrorEnvelope:
      properties:
        error:
          properties:
            code:
              type: string
            details:
              additionalProperties: true
              type: object
            message:
              type: string
            requestId:
              type: string
            retryable:
              type: boolean
          required:
          - code
          - message
          - requestId
          - retryable
          type: object
      required:
      - error
      type: object
    InstagramAudio:
      additionalProperties: false
      properties:
        artist:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        artistId:
          minLength: 1
          type:
          - string
          - 'null'
        artistName:
          minLength: 1
          type:
          - string
          - 'null'
        artwork:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        clusterId:
          minLength: 1
          type:
          - string
          - 'null'
        compositionStartTime:
          type:
          - number
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        duration:
          type:
          - number
          - 'null'
        fastStartUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        filters:
          items: {}
          type:
          - array
          - 'null'
        hasLyrics:
          type:
          - boolean
          - 'null'
        highlightStartTimes:
          items:
            type: number
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type: string
        isAutomaticallyAttributed:
          type:
          - boolean
          - 'null'
        isCrosspostedFromFacebook:
          type:
          - boolean
          - 'null'
        isExplicit:
          type:
          - boolean
          - 'null'
        isTrending:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramAudioMetrics'
        monetizationType:
          minLength: 1
          type:
          - string
          - 'null'
        musicId:
          minLength: 1
          type:
          - string
          - 'null'
        originalPostId:
          minLength: 1
          type:
          - string
          - 'null'
        overlapDuration:
          type:
          - number
          - 'null'
        parts:
          items:
            $ref: '#/components/schemas/InstagramAudioPart'
          type:
          - array
          - 'null'
        previewUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        spotify:
          additionalProperties: false
          properties:
            id:
              minLength: 1
              type:
              - string
              - 'null'
            url:
              format: uri
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - id
          - url
          type: object
        startTime:
          type:
          - number
          - 'null'
        streaming:
          anyOf:
          - $ref: '#/components/schemas/InstagramStreaming'
          - type: 'null'
        subtype:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - type
      - musicId
      - artistId
      - clusterId
      - title
      - artistName
      - artist
      - isExplicit
      - hasLyrics
      - isTrending
      - subtype
      - isAutomaticallyAttributed
      - isCrosspostedFromFacebook
      - monetizationType
      - duration
      - startTime
      - overlapDuration
      - compositionStartTime
      - createdAt
      - originalPostId
      - url
      - fastStartUrl
      - previewUrl
      - artwork
      - streaming
      - highlightStartTimes
      - filters
      - metrics
      - spotify
      - parts
      type: object
    InstagramAudioMetrics:
      additionalProperties: false
      properties:
        photos:
          type:
          - integer
          - 'null'
        previousTrendRank:
          type:
          - integer
          - 'null'
        reels:
          type:
          - integer
          - 'null'
        trendRank:
          type:
          - integer
          - 'null'
      required:
      - trendRank
      - previousTrendRank
      - reels
      - photos
      type: object
    InstagramAudioPart:
      additionalProperties: false
      properties:
        artist:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        artistName:
          minLength: 1
          type:
          - string
          - 'null'
        artwork:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        isExplicit:
          type:
          - boolean
          - 'null'
        musicId:
          minLength: 1
          type:
          - string
          - 'null'
        parentStartTime:
          type:
          - number
          - 'null'
        startTime:
          type:
          - number
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - type
      - title
      - artistName
      - isExplicit
      - musicId
      - artist
      - startTime
      - parentStartTime
      - artwork
      type: object
    InstagramAudioReference:
      additionalProperties: false
      properties:
        artist:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        artistId:
          minLength: 1
          type:
          - string
          - 'null'
        artistName:
          minLength: 1
          type:
          - string
          - 'null'
        artwork:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        clusterId:
          minLength: 1
          type:
          - string
          - 'null'
        compositionStartTime:
          type:
          - number
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        duration:
          type:
          - number
          - 'null'
        fastStartUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        filters:
          items: {}
          type:
          - array
          - 'null'
        hasLyrics:
          type:
          - boolean
          - 'null'
        highlightStartTimes:
          items:
            type: number
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAutomaticallyAttributed:
          type:
          - boolean
          - 'null'
        isCrosspostedFromFacebook:
          type:
          - boolean
          - 'null'
        isExplicit:
          type:
          - boolean
          - 'null'
        isTrending:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramAudioMetrics'
        monetizationType:
          minLength: 1
          type:
          - string
          - 'null'
        musicId:
          minLength: 1
          type:
          - string
          - 'null'
        originalPostId:
          minLength: 1
          type:
          - string
          - 'null'
        overlapDuration:
          type:
          - number
          - 'null'
        parts:
          items:
            $ref: '#/components/schemas/InstagramAudioPart'
          type:
          - array
          - 'null'
        previewUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        spotify:
          additionalProperties: false
          properties:
            id:
              minLength: 1
              type:
              - string
              - 'null'
            url:
              format: uri
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - id
          - url
          type: object
        startTime:
          type:
          - number
          - 'null'
        streaming:
          anyOf:
          - $ref: '#/components/schemas/InstagramStreaming'
          - type: 'null'
        subtype:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - type
      - musicId
      - artistId
      - clusterId
      - title
      - artistName
      - artist
      - isExplicit
      - hasLyrics
      - isTrending
      - subtype
      - isAutomaticallyAttributed
      - isCrosspostedFromFacebook
      - monetizationType
      - duration
      - startTime
      - overlapDuration
      - compositionStartTime
      - createdAt
      - originalPostId
      - url
      - fastStartUrl
      - previewUrl
      - artwork
      - streaming
      - highlightStartTimes
      - filters
      - metrics
      - spotify
      - parts
      type: object
    InstagramBioLink:
      additionalProperties: false
      properties:
        icon:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        image:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - title
      - url
      - type
      - isPinned
      - isVerified
      - icon
      - image
      type: object
    InstagramClipMetadata:
      additionalProperties: false
      properties:
        audio:
          anyOf:
          - $ref: '#/components/schemas/InstagramAudioReference'
          - type: 'null'
        partial:
          anyOf:
          - $ref: '#/components/schemas/InstagramPartialData'
          - type: 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - postId
      - audio
      - partial
      type: object
    InstagramComment:
      additionalProperties: false
      properties:
        ai:
          additionalProperties: false
          properties:
            type:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - type
          type: object
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        id:
          minLength: 1
          type: string
        isByPostAuthor:
          type:
          - boolean
          - 'null'
        isCovered:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isLikedByPostAuthor:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        keywords:
          items: {}
          type:
          - array
          - 'null'
        likedByCoauthors:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/InstagramImage'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramCommentMetrics'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
        pinnedPosition:
          type:
          - integer
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        previewUsers:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        ranking:
          additionalProperties: false
          properties:
            index:
              type:
              - integer
              - 'null'
            isRanked:
              type:
              - boolean
              - 'null'
            replyIndex:
              type:
              - integer
              - 'null'
          required:
          - index
          - replyIndex
          - isRanked
          type: object
        replies:
          items:
            $ref: '#/components/schemas/InstagramCommentReference'
          type:
          - array
          - 'null'
        replyToId:
          minLength: 1
          type:
          - string
          - 'null'
        sharingEnabled:
          type:
          - boolean
          - 'null'
        status:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        translation:
          additionalProperties: false
          properties:
            text:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - text
          type: object
      required:
      - id
      - text
      - postId
      - parentId
      - replyToId
      - createdAt
      - author
      - status
      - isCovered
      - isEdited
      - sharingEnabled
      - isByPostAuthor
      - isPinned
      - pinnedPosition
      - isLikedByPostAuthor
      - ai
      - ranking
      - keywords
      - previewUsers
      - metrics
      - replies
      - translation
      - likedByCoauthors
      - media
      type: object
    InstagramCommentMetadata:
      additionalProperties: false
      properties:
        comments:
          $ref: '#/components/schemas/InstagramCommentSettings'
        metrics:
          additionalProperties: false
          properties:
            comments:
              type:
              - integer
              - 'null'
          required:
          - comments
          type: object
        postId:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - postId
      - metrics
      - comments
      type: object
    InstagramCommentMetrics:
      additionalProperties: false
      properties:
        likes:
          type:
          - integer
          - 'null'
        replies:
          type:
          - integer
          - 'null'
      required:
      - likes
      - replies
      type: object
    InstagramCommentModeration:
      additionalProperties: false
      properties:
        isOffensive:
          type:
          - boolean
          - 'null'
      required:
      - isOffensive
      type: object
    InstagramCommentReference:
      additionalProperties: false
      properties:
        ai:
          additionalProperties: false
          properties:
            type:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - type
          type: object
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isByPostAuthor:
          type:
          - boolean
          - 'null'
        isCovered:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isLikedByPostAuthor:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        keywords:
          items: {}
          type:
          - array
          - 'null'
        likedByCoauthors:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/InstagramImage'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramCommentMetrics'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
        pinnedPosition:
          type:
          - integer
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        previewUsers:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        ranking:
          additionalProperties: false
          properties:
            index:
              type:
              - integer
              - 'null'
            isRanked:
              type:
              - boolean
              - 'null'
            replyIndex:
              type:
              - integer
              - 'null'
          required:
          - index
          - replyIndex
          - isRanked
          type: object
        replies:
          items:
            $ref: '#/components/schemas/InstagramCommentReference'
          type:
          - array
          - 'null'
        replyToId:
          minLength: 1
          type:
          - string
          - 'null'
        sharingEnabled:
          type:
          - boolean
          - 'null'
        status:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        translation:
          additionalProperties: false
          properties:
            text:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - text
          type: object
      required:
      - id
      - text
      - postId
      - parentId
      - replyToId
      - createdAt
      - author
      - status
      - isCovered
      - isEdited
      - sharingEnabled
      - isByPostAuthor
      - isPinned
      - pinnedPosition
      - isLikedByPostAuthor
      - ai
      - ranking
      - keywords
      - previewUsers
      - metrics
      - replies
      - translation
      - likedByCoauthors
      - media
      type: object
    InstagramCommentSettings:
      additionalProperties: false
      properties:
        enabled:
          type:
          - boolean
          - 'null'
        hasMore:
          type:
          - boolean
          - 'null'
        likesEnabled:
          type:
          - boolean
          - 'null'
        maxVisiblePreviewComments:
          type:
          - integer
          - 'null'
        preview:
          items:
            $ref: '#/components/schemas/InstagramCommentReference'
          type:
          - array
          - 'null'
        threadingEnabled:
          type:
          - boolean
          - 'null'
      required:
      - hasMore
      - maxVisiblePreviewComments
      - likesEnabled
      - threadingEnabled
      - enabled
      - preview
      type: object
    InstagramCoordinates:
      additionalProperties: false
      properties:
        latitude:
          type:
          - number
          - 'null'
        longitude:
          type:
          - number
          - 'null'
      required:
      - latitude
      - longitude
      type: object
    InstagramCrop:
      additionalProperties: false
      properties:
        bottom:
          type:
          - number
          - 'null'
        left:
          type:
          - number
          - 'null'
        right:
          type:
          - number
          - 'null'
        top:
          type:
          - number
          - 'null'
      required:
      - left
      - right
      - top
      - bottom
      type: object
    InstagramDASH:
      additionalProperties: false
      properties:
        manifest:
          minLength: 1
          type:
          - string
          - 'null'
        qualityCount:
          type:
          - integer
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/InstagramStreamVariant'
          type:
          - array
          - 'null'
      required:
      - manifest
      - variants
      - qualityCount
      type: object
    InstagramHashtag:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        isTrending:
          type:
          - boolean
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            posts:
              type:
              - integer
              - 'null'
            views:
              type:
              - integer
              - 'null'
          required:
          - posts
          - views
          type: object
        name:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - name
      - url
      - bio
      - avatar
      - isTrending
      - metrics
      type: object
    InstagramHashtagReference:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isTrending:
          type:
          - boolean
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            posts:
              type:
              - integer
              - 'null'
            views:
              type:
              - integer
              - 'null'
          required:
          - posts
          - views
          type: object
        name:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - url
      - bio
      - avatar
      - isTrending
      - metrics
      type: object
    InstagramHighlight:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        cover:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        isArchived:
          type:
          - boolean
          - 'null'
        isConvertedToReel:
          type:
          - boolean
          - 'null'
        isInProfileGrid:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        lastStoryAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            stories:
              type:
              - integer
              - 'null'
          required:
          - stories
          type: object
        stories:
          items:
            $ref: '#/components/schemas/InstagramStoryReference'
          type:
          - array
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        updatedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - url
      - title
      - author
      - createdAt
      - updatedAt
      - lastStoryAt
      - isPinned
      - isArchived
      - isConvertedToReel
      - isInProfileGrid
      - cover
      - metrics
      - stories
      type: object
    InstagramHighlightReference:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - title
      type: object
    InstagramImage:
      additionalProperties: false
      properties:
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isDefault:
          type:
          - boolean
          - 'null'
        isSpatial:
          type:
          - boolean
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/InstagramImage'
          type:
          - array
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - thumbnail
      - id
      - type
      - url
      - width
      - height
      - isDefault
      - isSpatial
      - variants
      type: object
    InstagramLocation:
      additionalProperties: false
      properties:
        address:
          $ref: '#/components/schemas/InstagramLocationAddress'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        coordinates:
          $ref: '#/components/schemas/InstagramCoordinates'
        external:
          additionalProperties: false
          properties:
            id:
              minLength: 1
              type:
              - string
              - 'null'
            source:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - id
          - source
          type: object
        hours:
          anyOf:
          - $ref: '#/components/schemas/InstagramLocationHours'
          - type: 'null'
        id:
          minLength: 1
          type: string
        name:
          minLength: 1
          type:
          - string
          - 'null'
        phone:
          minLength: 1
          type:
          - string
          - 'null'
        searchContext:
          additionalProperties: false
          properties:
            subtitle:
              minLength: 1
              type:
              - string
              - 'null'
            title:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - title
          - subtitle
          type: object
        shortName:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
        website:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - shortName
      - category
      - url
      - phone
      - website
      - address
      - coordinates
      - external
      - searchContext
      - hours
      type: object
    InstagramLocationAddress:
      additionalProperties: false
      properties:
        city:
          minLength: 1
          type:
          - string
          - 'null'
        countryCode:
          minLength: 1
          type:
          - string
          - 'null'
        postalCode:
          minLength: 1
          type:
          - string
          - 'null'
        region:
          minLength: 1
          type:
          - string
          - 'null'
        street:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - street
      - city
      - postalCode
      - region
      - countryCode
      type: object
    InstagramLocationHours:
      additionalProperties: false
      properties:
        currentStatus:
          minLength: 1
          type:
          - string
          - 'null'
        isOpen:
          type:
          - boolean
          - 'null'
        schedule:
          items: {}
          type:
          - array
          - 'null'
        status:
          minLength: 1
          type:
          - string
          - 'null'
        today:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - status
      - currentStatus
      - today
      - isOpen
      - schedule
      type: object
    InstagramLocationReference:
      additionalProperties: false
      properties:
        address:
          $ref: '#/components/schemas/InstagramLocationAddress'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        coordinates:
          $ref: '#/components/schemas/InstagramCoordinates'
        external:
          additionalProperties: false
          properties:
            id:
              minLength: 1
              type:
              - string
              - 'null'
            source:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - id
          - source
          type: object
        hours:
          anyOf:
          - $ref: '#/components/schemas/InstagramLocationHours'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        phone:
          minLength: 1
          type:
          - string
          - 'null'
        searchContext:
          additionalProperties: false
          properties:
            subtitle:
              minLength: 1
              type:
              - string
              - 'null'
            title:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - title
          - subtitle
          type: object
        shortName:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        website:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - shortName
      - category
      - url
      - phone
      - website
      - address
      - coordinates
      - external
      - searchContext
      - hours
      type: object
    InstagramMedia:
      additionalProperties: false
      properties:
        altText:
          minLength: 1
          type:
          - string
          - 'null'
        audio:
          anyOf:
          - $ref: '#/components/schemas/InstagramAudioReference'
          - type: 'null'
        bitrate:
          type:
          - integer
          - 'null'
        commercialityStatus:
          minLength: 1
          type:
          - string
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        crops:
          additionalProperties: false
          properties:
            feedPreview:
              $ref: '#/components/schemas/InstagramCrop'
            fourByThree:
              $ref: '#/components/schemas/InstagramCrop'
            square:
              $ref: '#/components/schemas/InstagramCrop'
          required:
          - fourByThree
          - square
          - feedPreview
          type: object
        duration:
          type:
          - number
          - 'null'
        firstFrame:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        hasAudio:
          type:
          - boolean
          - 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        originalHeight:
          type:
          - integer
          - 'null'
        originalWidth:
          type:
          - integer
          - 'null'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
        productTags:
          items:
            $ref: '#/components/schemas/InstagramProductTag'
          type:
          - array
          - 'null'
        scrubber:
          anyOf:
          - $ref: '#/components/schemas/InstagramScrubber'
          - type: 'null'
        streaming:
          anyOf:
          - $ref: '#/components/schemas/InstagramStreaming'
          - type: 'null'
        subtitles:
          anyOf:
          - $ref: '#/components/schemas/InstagramSubtitles'
          - type: 'null'
        taggedUsers:
          items:
            $ref: '#/components/schemas/InstagramUserTag'
          type:
          - array
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/InstagramMediaVariant'
          type:
          - array
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - id
      - type
      - parentId
      - createdAt
      - url
      - width
      - height
      - originalWidth
      - originalHeight
      - bitrate
      - hasAudio
      - altText
      - commercialityStatus
      - duration
      - variants
      - thumbnail
      - firstFrame
      - scrubber
      - streaming
      - subtitles
      - audio
      - taggedUsers
      - productTags
      - crops
      type: object
    InstagramMediaPreview:
      additionalProperties: false
      properties:
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
      required:
      - id
      - fbid
      - thumbnail
      type: object
    InstagramMediaVariant:
      additionalProperties: false
      properties:
        bitrate:
          type:
          - integer
          - 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isSpatial:
          type:
          - boolean
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - id
      - type
      - url
      - width
      - height
      - bitrate
      - isSpatial
      type: object
    InstagramMusic:
      additionalProperties: false
      properties:
        artist:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        artistId:
          minLength: 1
          type:
          - string
          - 'null'
        artistName:
          minLength: 1
          type:
          - string
          - 'null'
        artwork:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        clusterId:
          minLength: 1
          type:
          - string
          - 'null'
        compositionStartTime:
          type:
          - number
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        duration:
          type:
          - number
          - 'null'
        fastStartUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        filters:
          items: {}
          type:
          - array
          - 'null'
        hasLyrics:
          type:
          - boolean
          - 'null'
        highlightStartTimes:
          items:
            type: number
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type: string
        isAutomaticallyAttributed:
          type:
          - boolean
          - 'null'
        isCrosspostedFromFacebook:
          type:
          - boolean
          - 'null'
        isExplicit:
          type:
          - boolean
          - 'null'
        isTrending:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramAudioMetrics'
        monetizationType:
          minLength: 1
          type:
          - string
          - 'null'
        musicId:
          minLength: 1
          type:
          - string
          - 'null'
        originalPostId:
          minLength: 1
          type:
          - string
          - 'null'
        overlapDuration:
          type:
          - number
          - 'null'
        parts:
          items:
            $ref: '#/components/schemas/InstagramAudioPart'
          type:
          - array
          - 'null'
        posts:
          items:
            $ref: '#/components/schemas/InstagramPostReference'
          type:
          - array
          - 'null'
        previewUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        spotify:
          additionalProperties: false
          properties:
            id:
              minLength: 1
              type:
              - string
              - 'null'
            url:
              format: uri
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - id
          - url
          type: object
        startTime:
          type:
          - number
          - 'null'
        streaming:
          anyOf:
          - $ref: '#/components/schemas/InstagramStreaming'
          - type: 'null'
        subtype:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        usageLabel:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - type
      - musicId
      - artistId
      - clusterId
      - title
      - artistName
      - artist
      - isExplicit
      - hasLyrics
      - isTrending
      - subtype
      - isAutomaticallyAttributed
      - isCrosspostedFromFacebook
      - monetizationType
      - duration
      - startTime
      - overlapDuration
      - compositionStartTime
      - createdAt
      - originalPostId
      - url
      - fastStartUrl
      - previewUrl
      - artwork
      - streaming
      - highlightStartTimes
      - filters
      - metrics
      - spotify
      - parts
      - usageLabel
      - posts
      type: object
    InstagramMusicStream:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type: string
        media:
          items:
            $ref: '#/components/schemas/InstagramMedia'
          type: array
        metrics:
          $ref: '#/components/schemas/InstagramMusicStreamMetrics'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - type
      - media
      - metrics
      type: object
    InstagramMusicStreamMetrics:
      additionalProperties: false
      properties:
        plays:
          type:
          - integer
          - 'null'
      required:
      - plays
      type: object
    InstagramNote:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - text
      - createdAt
      - author
      type: object
    InstagramOEmbed:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        height:
          type:
          - integer
          - 'null'
        html:
          minLength: 1
          type:
          - string
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        provider:
          additionalProperties: false
          properties:
            name:
              minLength: 1
              type:
              - string
              - 'null'
            url:
              format: uri
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - name
          - url
          type: object
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - postId
      - type
      - title
      - html
      - width
      - height
      - author
      - provider
      - thumbnail
      type: object
    InstagramPageMetadata:
      additionalProperties: false
      properties:
        collection:
          anyOf:
          - $ref: '#/components/schemas/InstagramStoryCollection'
          - type: 'null'
        hasMore:
          type:
          - boolean
          - 'null'
        hasMoreAfter:
          type:
          - boolean
          - 'null'
        hasMoreBefore:
          type:
          - boolean
          - 'null'
        likesEnabled:
          type:
          - boolean
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            comments:
              type:
              - integer
              - 'null'
            likes:
              type:
              - integer
              - 'null'
            replies:
              type:
              - integer
              - 'null'
          required:
          - likes
          - comments
          - replies
          type: object
        parent:
          anyOf:
          - $ref: '#/components/schemas/InstagramCommentReference'
          - type: 'null'
        threadingEnabled:
          type:
          - boolean
          - 'null'
        track:
          anyOf:
          - $ref: '#/components/schemas/InstagramAudioReference'
          - type: 'null'
      required:
      - metrics
      - threadingEnabled
      - likesEnabled
      - hasMore
      - hasMoreBefore
      - hasMoreAfter
      - parent
      - collection
      - track
      type: object
    InstagramPartialData:
      additionalProperties: false
      properties:
        errors:
          items:
            $ref: '#/components/schemas/InstagramPartialError'
          type:
          - array
          - 'null'
      required:
      - errors
      type: object
    InstagramPartialError:
      additionalProperties: false
      properties:
        message:
          minLength: 1
          type:
          - string
          - 'null'
        path:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
      required:
      - message
      - path
      type: object
    InstagramPosition:
      additionalProperties: false
      properties:
        x:
          type:
          - number
          - 'null'
        y:
          type:
          - number
          - 'null'
      required:
      - x
      - y
      type: object
    InstagramPost:
      additionalProperties: false
      properties:
        ai:
          additionalProperties: false
          properties:
            detectionMethod:
              minLength: 1
              type:
              - string
              - 'null'
            label:
              additionalProperties: false
              properties:
                detectionMethod:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                isSelfDisclosed:
                  type:
                  - boolean
                  - 'null'
                subtitle:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                text:
                  minLength: 1
                  type:
                  - string
                  - 'null'
              required:
              - text
              - subtitle
              - detectionMethod
              - isSelfDisclosed
              type: object
          required:
          - detectionMethod
          - label
          type: object
        attribution:
          additionalProperties: false
          properties:
            originalPost:
              anyOf:
              - $ref: '#/components/schemas/InstagramPostReference'
              - type: 'null'
          required:
          - originalPost
          type: object
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        caption:
          anyOf:
          - $ref: '#/components/schemas/InstagramCommentReference'
          - type: 'null'
        carousel:
          additionalProperties: false
          properties:
            itemCount:
              type:
              - integer
              - 'null'
            pendingItemCount:
              type:
              - integer
              - 'null'
            previousSubmitters:
              items:
                $ref: '#/components/schemas/InstagramProfileReference'
              type:
              - array
              - 'null'
            submissionState:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - itemCount
          - pendingItemCount
          - submissionState
          - previousSubmitters
          type: object
        code:
          minLength: 1
          type:
          - string
          - 'null'
        collaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        comments:
          $ref: '#/components/schemas/InstagramCommentSettings'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        crossposting:
          additionalProperties: false
          properties:
            isFeedbackAggregated:
              type:
              - boolean
              - 'null'
            isSharedToFacebook:
              type:
              - boolean
              - 'null'
          required:
          - isSharedToFacebook
          - isFeedbackAggregated
          type: object
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        hasDelayedMetadata:
          type:
          - boolean
          - 'null'
        hasTaggedUsers:
          type:
          - boolean
          - 'null'
        hasVisualReplies:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type: string
        invitedCollaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        isEarlyAccess:
          type:
          - boolean
          - 'null'
        isFanClubPromo:
          type:
          - boolean
          - 'null'
        isOpenToPublicSubmission:
          type:
          - boolean
          - 'null'
        isPaidPartnership:
          type:
          - boolean
          - 'null'
        isPublicChatWelcomeVideo:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        likeAndViewCountsHidden:
          type:
          - boolean
          - 'null'
        location:
          anyOf:
          - $ref: '#/components/schemas/InstagramLocationReference'
          - type: 'null'
        media:
          items:
            $ref: '#/components/schemas/InstagramMedia'
          type: array
        metrics:
          $ref: '#/components/schemas/InstagramPostMetrics'
        notes:
          items:
            $ref: '#/components/schemas/InstagramNote'
          type:
          - array
          - 'null'
        pinning:
          additionalProperties: false
          properties:
            profileUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
            reelsUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
          required:
          - profileUserIds
          - reelsUserIds
          type: object
        productTags:
          items:
            $ref: '#/components/schemas/InstagramProductTag'
          type:
          - array
          - 'null'
        remix:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            carouselRemixesAllowed:
              type:
              - boolean
              - 'null'
            crosspostingAllowed:
              type:
              - boolean
              - 'null'
            hasBeenRemixed:
              type:
              - boolean
              - 'null'
            isRequestingRemixes:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - carouselRemixesAllowed
          - hasBeenRemixed
          - isRequestingRemixes
          - crosspostingAllowed
          type: object
        reuse:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            cutoutStickersAllowed:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - cutoutStickersAllowed
          type: object
        shareCountHidden:
          type:
          - boolean
          - 'null'
        sharingEnabled:
          type:
          - boolean
          - 'null'
        taggedUsers:
          items:
            $ref: '#/components/schemas/InstagramUserTag'
          type:
          - array
          - 'null'
        template:
          anyOf:
          - $ref: '#/components/schemas/InstagramTemplateInfo'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - code
      - fbid
      - type
      - url
      - title
      - text
      - createdAt
      - author
      - caption
      - media
      - metrics
      - comments
      - taggedUsers
      - productTags
      - collaborators
      - invitedCollaborators
      - location
      - isPaidPartnership
      - isEarlyAccess
      - likeAndViewCountsHidden
      - shareCountHidden
      - hasVisualReplies
      - hasDelayedMetadata
      - language
      - hasTaggedUsers
      - isOpenToPublicSubmission
      - sharingEnabled
      - isFanClubPromo
      - isPublicChatWelcomeVideo
      - reuse
      - remix
      - pinning
      - carousel
      - ai
      - notes
      - crossposting
      - attribution
      - template
      type: object
    InstagramPostInsight:
      additionalProperties: false
      properties:
        authorId:
          minLength: 1
          type:
          - string
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        facebook:
          additionalProperties: false
          properties:
            accountId:
              minLength: 1
              type:
              - string
              - 'null'
            actorId:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - actorId
          - accountId
          type: object
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        hasProductTags:
          type:
          - boolean
          - 'null'
        image:
          additionalProperties: false
          properties:
            height:
              type:
              - integer
              - 'null'
            width:
              type:
              - integer
              - 'null'
          required:
          - width
          - height
          type: object
        metrics:
          additionalProperties: false
          properties:
            comments:
              type:
              - integer
              - 'null'
            likes:
              type:
              - integer
              - 'null'
            saves:
              type:
              - integer
              - 'null'
            shopping:
              additionalProperties: false
              properties:
                productClicks:
                  items: {}
                  type:
                  - array
                  - 'null'
                productOutboundClicks:
                  items: {}
                  type:
                  - array
                  - 'null'
              required:
              - productClicks
              - productOutboundClicks
              type: object
            shoppingOutboundClicks:
              type:
              - integer
              - 'null'
            shoppingProductClicks:
              type:
              - integer
              - 'null'
          required:
          - likes
          - comments
          - saves
          - shoppingOutboundClicks
          - shoppingProductClicks
          - shopping
          type: object
        organicPostId:
          minLength: 1
          type:
          - string
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - postId
      - fbid
      - authorId
      - organicPostId
      - createdAt
      - type
      - hasProductTags
      - thumbnail
      - image
      - metrics
      - facebook
      type: object
    InstagramPostMetrics:
      additionalProperties: false
      properties:
        comments:
          type:
          - integer
          - 'null'
        facebook:
          additionalProperties: false
          properties:
            comments:
              type:
              - integer
              - 'null'
            likes:
              type:
              - integer
              - 'null'
            plays:
              type:
              - integer
              - 'null'
          required:
          - likes
          - plays
          - comments
          type: object
        instagram:
          additionalProperties: false
          properties:
            plays:
              type:
              - integer
              - 'null'
          required:
          - plays
          type: object
        likes:
          type:
          - integer
          - 'null'
        plays:
          type:
          - integer
          - 'null'
        premiumReactions:
          type:
          - integer
          - 'null'
        reposts:
          type:
          - integer
          - 'null'
        reshares:
          type:
          - integer
          - 'null'
        saves:
          type:
          - integer
          - 'null'
        views:
          type:
          - integer
          - 'null'
      required:
      - likes
      - comments
      - saves
      - reshares
      - reposts
      - premiumReactions
      - plays
      - views
      - instagram
      - facebook
      type: object
    InstagramPostReference:
      additionalProperties: false
      properties:
        ai:
          additionalProperties: false
          properties:
            detectionMethod:
              minLength: 1
              type:
              - string
              - 'null'
            label:
              additionalProperties: false
              properties:
                detectionMethod:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                isSelfDisclosed:
                  type:
                  - boolean
                  - 'null'
                subtitle:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                text:
                  minLength: 1
                  type:
                  - string
                  - 'null'
              required:
              - text
              - subtitle
              - detectionMethod
              - isSelfDisclosed
              type: object
          required:
          - detectionMethod
          - label
          type: object
        attribution:
          additionalProperties: false
          properties:
            originalPost:
              anyOf:
              - $ref: '#/components/schemas/InstagramPostReference'
              - type: 'null'
          required:
          - originalPost
          type: object
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        caption:
          anyOf:
          - $ref: '#/components/schemas/InstagramCommentReference'
          - type: 'null'
        carousel:
          additionalProperties: false
          properties:
            itemCount:
              type:
              - integer
              - 'null'
            pendingItemCount:
              type:
              - integer
              - 'null'
            previousSubmitters:
              items:
                $ref: '#/components/schemas/InstagramProfileReference'
              type:
              - array
              - 'null'
            submissionState:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - itemCount
          - pendingItemCount
          - submissionState
          - previousSubmitters
          type: object
        code:
          minLength: 1
          type:
          - string
          - 'null'
        collaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        comments:
          $ref: '#/components/schemas/InstagramCommentSettings'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        crossposting:
          additionalProperties: false
          properties:
            isFeedbackAggregated:
              type:
              - boolean
              - 'null'
            isSharedToFacebook:
              type:
              - boolean
              - 'null'
          required:
          - isSharedToFacebook
          - isFeedbackAggregated
          type: object
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        hasDelayedMetadata:
          type:
          - boolean
          - 'null'
        hasTaggedUsers:
          type:
          - boolean
          - 'null'
        hasVisualReplies:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        invitedCollaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        isEarlyAccess:
          type:
          - boolean
          - 'null'
        isFanClubPromo:
          type:
          - boolean
          - 'null'
        isOpenToPublicSubmission:
          type:
          - boolean
          - 'null'
        isPaidPartnership:
          type:
          - boolean
          - 'null'
        isPublicChatWelcomeVideo:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        likeAndViewCountsHidden:
          type:
          - boolean
          - 'null'
        location:
          anyOf:
          - $ref: '#/components/schemas/InstagramLocationReference'
          - type: 'null'
        media:
          items:
            $ref: '#/components/schemas/InstagramMedia'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramPostMetrics'
        notes:
          items:
            $ref: '#/components/schemas/InstagramNote'
          type:
          - array
          - 'null'
        pinning:
          additionalProperties: false
          properties:
            profileUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
            reelsUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
          required:
          - profileUserIds
          - reelsUserIds
          type: object
        productTags:
          items:
            $ref: '#/components/schemas/InstagramProductTag'
          type:
          - array
          - 'null'
        remix:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            carouselRemixesAllowed:
              type:
              - boolean
              - 'null'
            crosspostingAllowed:
              type:
              - boolean
              - 'null'
            hasBeenRemixed:
              type:
              - boolean
              - 'null'
            isRequestingRemixes:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - carouselRemixesAllowed
          - hasBeenRemixed
          - isRequestingRemixes
          - crosspostingAllowed
          type: object
        reuse:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            cutoutStickersAllowed:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - cutoutStickersAllowed
          type: object
        shareCountHidden:
          type:
          - boolean
          - 'null'
        sharingEnabled:
          type:
          - boolean
          - 'null'
        taggedUsers:
          items:
            $ref: '#/components/schemas/InstagramUserTag'
          type:
          - array
          - 'null'
        template:
          anyOf:
          - $ref: '#/components/schemas/InstagramTemplateInfo'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - code
      - fbid
      - type
      - url
      - title
      - text
      - createdAt
      - author
      - caption
      - media
      - metrics
      - comments
      - taggedUsers
      - productTags
      - collaborators
      - invitedCollaborators
      - location
      - isPaidPartnership
      - isEarlyAccess
      - likeAndViewCountsHidden
      - shareCountHidden
      - hasVisualReplies
      - hasDelayedMetadata
      - language
      - hasTaggedUsers
      - isOpenToPublicSubmission
      - sharingEnabled
      - isFanClubPromo
      - isPublicChatWelcomeVideo
      - reuse
      - remix
      - pinning
      - carousel
      - ai
      - notes
      - crossposting
      - attribution
      - template
      type: object
    InstagramPrice:
      additionalProperties: false
      properties:
        amount:
          minLength: 1
          type:
          - string
          - 'null'
        formatted:
          minLength: 1
          type:
          - string
          - 'null'
        strippedFormatted:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - amount
      - formatted
      - strippedFormatted
      type: object
    InstagramProduct:
      additionalProperties: false
      properties:
        checkout:
          additionalProperties: false
          properties:
            style:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - style
          type: object
        compoundId:
          minLength: 1
          type:
          - string
          - 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        hasVariants:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        image:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        isAffiliate:
          type:
          - boolean
          - 'null'
        isInStock:
          type:
          - boolean
          - 'null'
        merchant:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        pricing:
          additionalProperties: false
          properties:
            current:
              $ref: '#/components/schemas/InstagramPrice'
            formatted:
              minLength: 1
              type:
              - string
              - 'null'
            full:
              $ref: '#/components/schemas/InstagramPrice'
            isUkEuCompliant:
              type:
              - boolean
              - 'null'
          required:
          - current
          - full
          - formatted
          - isUkEuCompliant
          type: object
        retailerId:
          minLength: 1
          type:
          - string
          - 'null'
        reviewStatus:
          minLength: 1
          type:
          - string
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - compoundId
      - retailerId
      - name
      - description
      - url
      - hasVariants
      - isInStock
      - isAffiliate
      - reviewStatus
      - merchant
      - image
      - thumbnail
      - pricing
      - checkout
      type: object
    InstagramProductTag:
      additionalProperties: false
      properties:
        position:
          $ref: '#/components/schemas/InstagramPosition'
        product:
          $ref: '#/components/schemas/InstagramProduct'
      required:
      - product
      - position
      type: object
    InstagramProfile:
      additionalProperties: false
      properties:
        accountBadges:
          items: {}
          type:
          - array
          - 'null'
        accountType:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileAccountType'
          - type: 'null'
        avatar:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        bioEntities:
          items: {}
          type:
          - array
          - 'null'
        bioLinks:
          items:
            $ref: '#/components/schemas/InstagramBioLink'
          type:
          - array
          - 'null'
        broadcastChannels:
          $ref: '#/components/schemas/InstagramProfileBroadcastChannels'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        categoryId:
          minLength: 1
          type:
          - string
          - 'null'
        contact:
          $ref: '#/components/schemas/InstagramProfileContact'
        content:
          $ref: '#/components/schemas/InstagramProfileContent'
        contentSettings:
          $ref: '#/components/schemas/InstagramProfileContentSettings'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        displaySettings:
          $ref: '#/components/schemas/InstagramProfileDisplaySettings'
        externalUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        fanClub:
          $ref: '#/components/schemas/InstagramProfileFanClub'
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        fundraisers:
          $ref: '#/components/schemas/InstagramProfileFundraisers'
        handle:
          minLength: 1
          type: string
        hasDigitalAvatar:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type: string
        isAccountTransparencyVisible:
          type:
          - boolean
          - 'null'
        isBusiness:
          type:
          - boolean
          - 'null'
        isFacebookOnboardedCharity:
          type:
          - boolean
          - 'null'
        isMemorialized:
          type:
          - boolean
          - 'null'
        isNew:
          type:
          - boolean
          - 'null'
        isOpenToCollaboration:
          type:
          - boolean
          - 'null'
        isPotentialBusiness:
          type:
          - boolean
          - 'null'
        isPrivate:
          type:
          - boolean
          - 'null'
        isUnpublished:
          type:
          - boolean
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        lastStoryAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        location:
          $ref: '#/components/schemas/InstagramProfileLocation'
        mediaPreviews:
          items:
            $ref: '#/components/schemas/InstagramMediaPreview'
          type:
          - array
          - 'null'
        messagingFbid:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramProfileMetrics'
        pronouns:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        socialContext:
          minLength: 1
          type:
          - string
          - 'null'
        suggestion:
          anyOf:
          - $ref: '#/components/schemas/InstagramSuggestion'
          - type: 'null'
        threads:
          $ref: '#/components/schemas/InstagramProfileThreads'
        upcomingEvents:
          items: {}
          type:
          - array
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - suggestion
      - mediaPreviews
      - id
      - handle
      - displayName
      - bio
      - url
      - externalUrl
      - avatar
      - fbid
      - messagingFbid
      - isPrivate
      - isVerified
      - isBusiness
      - isPotentialBusiness
      - isUnpublished
      - isMemorialized
      - isNew
      - isOpenToCollaboration
      - isFacebookOnboardedCharity
      - hasDigitalAvatar
      - isAccountTransparencyVisible
      - category
      - categoryId
      - accountType
      - socialContext
      - lastStoryAt
      - pronouns
      - accountBadges
      - bioEntities
      - bioLinks
      - upcomingEvents
      - metrics
      - contact
      - location
      - fanClub
      - content
      - contentSettings
      - displaySettings
      - threads
      - broadcastChannels
      - fundraisers
      type: object
    InstagramProfileAbout:
      additionalProperties: false
      properties:
        country:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        joinedAt:
          description: Account creation month. Day and time are unavailable.
          pattern: ^\d{4}-\d{2}$
          type:
          - string
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            handleChanges:
              type:
              - integer
              - 'null'
          required:
          - handleChanges
          type: object
      required:
      - handle
      - country
      - joinedAt
      - isVerified
      - metrics
      type: object
    InstagramProfileAccountType:
      oneOf:
      - enum:
        - personal
        - business
        - creator
        type: string
      - type: integer
    InstagramProfileAddress:
      additionalProperties: false
      properties:
        city:
          minLength: 1
          type:
          - string
          - 'null'
        cityId:
          minLength: 1
          type:
          - string
          - 'null'
        postalCode:
          minLength: 1
          type:
          - string
          - 'null'
        street:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - street
      - city
      - cityId
      - postalCode
      type: object
    InstagramProfileBroadcastChannel:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        cover:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        creator:
          additionalProperties: false
          properties:
            handle:
              minLength: 1
              type:
              - string
              - 'null'
            id:
              minLength: 1
              type:
              - string
              - 'null'
            isVerified:
              type:
              - boolean
              - 'null'
          required:
          - id
          - handle
          - isVerified
          type: object
        id:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            members:
              type:
              - integer
              - 'null'
          required:
          - members
          type: object
        title:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - title
      - url
      - avatar
      - cover
      - creator
      - metrics
      type: object
    InstagramProfileBroadcastChannels:
      additionalProperties: false
      properties:
        hasPublicChannels:
          type:
          - boolean
          - 'null'
        isCreator:
          type:
          - boolean
          - 'null'
        pinned:
          items:
            $ref: '#/components/schemas/InstagramProfileBroadcastChannel'
          type:
          - array
          - 'null'
      required:
      - isCreator
      - hasPublicChannels
      - pinned
      type: object
    InstagramProfileContact:
      additionalProperties: false
      properties:
        contactPhone:
          minLength: 1
          type:
          - string
          - 'null'
        email:
          minLength: 1
          type:
          - string
          - 'null'
        method:
          minLength: 1
          type:
          - string
          - 'null'
        phone:
          minLength: 1
          type:
          - string
          - 'null'
        phoneCountryCode:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - email
      - phone
      - phoneCountryCode
      - contactPhone
      - method
      type: object
    InstagramProfileContent:
      additionalProperties: false
      properties:
        hasGuides:
          type:
          - boolean
          - 'null'
        hasHighlights:
          type:
          - boolean
          - 'null'
        hasLongformMedia:
          type:
          - boolean
          - 'null'
        hasMusic:
          type:
          - boolean
          - 'null'
        hasVideos:
          type:
          - boolean
          - 'null'
        hasVisibleNotes:
          type:
          - boolean
          - 'null'
      required:
      - hasHighlights
      - hasLongformMedia
      - hasVideos
      - hasMusic
      - hasGuides
      - hasVisibleNotes
      type: object
    InstagramProfileContentSettings:
      additionalProperties: false
      properties:
        highlightResharingEnabled:
          type:
          - boolean
          - 'null'
        postRemixingEnabled:
          type:
          - boolean
          - 'null'
        postResharingEnabled:
          type:
          - boolean
          - 'null'
        reelRemixingEnabled:
          type:
          - boolean
          - 'null'
      required:
      - postResharingEnabled
      - highlightResharingEnabled
      - postRemixingEnabled
      - reelRemixingEnabled
      type: object
    InstagramProfileDisplaySettings:
      additionalProperties: false
      properties:
        showCategory:
          type:
          - boolean
          - 'null'
        showPublicContacts:
          type:
          - boolean
          - 'null'
      required:
      - showCategory
      - showPublicContacts
      type: object
    InstagramProfileFanClub:
      additionalProperties: false
      properties:
        hasExclusiveFeedContent:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        largestPublicBroadcastChannelId:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            subscribers:
              type:
              - integer
              - 'null'
          required:
          - subscribers
          type: object
        name:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - largestPublicBroadcastChannelId
      - hasExclusiveFeedContent
      - metrics
      type: object
    InstagramProfileFundraisers:
      additionalProperties: false
      properties:
        items:
          items: {}
          type:
          - array
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            active:
              type:
              - integer
              - 'null'
          required:
          - active
          type: object
      required:
      - metrics
      - items
      type: object
    InstagramProfileLocation:
      additionalProperties: false
      properties:
        address:
          $ref: '#/components/schemas/InstagramProfileAddress'
        id:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - address
      type: object
    InstagramProfileMetrics:
      additionalProperties: false
      properties:
        arEffects:
          type:
          - integer
          - 'null'
        followers:
          type:
          - integer
          - 'null'
        following:
          type:
          - integer
          - 'null'
        posts:
          type:
          - integer
          - 'null'
      required:
      - followers
      - following
      - posts
      - arEffects
      type: object
    InstagramProfileReference:
      additionalProperties: false
      properties:
        accountBadges:
          items: {}
          type:
          - array
          - 'null'
        accountType:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileAccountType'
          - type: 'null'
        avatar:
          anyOf:
          - $ref: '#/components/schemas/InstagramImage'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        bioEntities:
          items: {}
          type:
          - array
          - 'null'
        bioLinks:
          items:
            $ref: '#/components/schemas/InstagramBioLink'
          type:
          - array
          - 'null'
        broadcastChannels:
          $ref: '#/components/schemas/InstagramProfileBroadcastChannels'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        categoryId:
          minLength: 1
          type:
          - string
          - 'null'
        contact:
          $ref: '#/components/schemas/InstagramProfileContact'
        content:
          $ref: '#/components/schemas/InstagramProfileContent'
        contentSettings:
          $ref: '#/components/schemas/InstagramProfileContentSettings'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        displaySettings:
          $ref: '#/components/schemas/InstagramProfileDisplaySettings'
        externalUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        fanClub:
          $ref: '#/components/schemas/InstagramProfileFanClub'
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        fundraisers:
          $ref: '#/components/schemas/InstagramProfileFundraisers'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        hasDigitalAvatar:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAccountTransparencyVisible:
          type:
          - boolean
          - 'null'
        isBusiness:
          type:
          - boolean
          - 'null'
        isFacebookOnboardedCharity:
          type:
          - boolean
          - 'null'
        isMemorialized:
          type:
          - boolean
          - 'null'
        isNew:
          type:
          - boolean
          - 'null'
        isOpenToCollaboration:
          type:
          - boolean
          - 'null'
        isPotentialBusiness:
          type:
          - boolean
          - 'null'
        isPrivate:
          type:
          - boolean
          - 'null'
        isUnpublished:
          type:
          - boolean
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        lastStoryAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        location:
          $ref: '#/components/schemas/InstagramProfileLocation'
        mediaPreviews:
          items:
            $ref: '#/components/schemas/InstagramMediaPreview'
          type:
          - array
          - 'null'
        messagingFbid:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramProfileMetrics'
        pronouns:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        socialContext:
          minLength: 1
          type:
          - string
          - 'null'
        suggestion:
          anyOf:
          - $ref: '#/components/schemas/InstagramSuggestion'
          - type: 'null'
        threads:
          $ref: '#/components/schemas/InstagramProfileThreads'
        upcomingEvents:
          items: {}
          type:
          - array
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - suggestion
      - mediaPreviews
      - id
      - handle
      - displayName
      - bio
      - url
      - externalUrl
      - avatar
      - fbid
      - messagingFbid
      - isPrivate
      - isVerified
      - isBusiness
      - isPotentialBusiness
      - isUnpublished
      - isMemorialized
      - isNew
      - isOpenToCollaboration
      - isFacebookOnboardedCharity
      - hasDigitalAvatar
      - isAccountTransparencyVisible
      - category
      - categoryId
      - accountType
      - socialContext
      - lastStoryAt
      - pronouns
      - accountBadges
      - bioEntities
      - bioLinks
      - upcomingEvents
      - metrics
      - contact
      - location
      - fanClub
      - content
      - contentSettings
      - displaySettings
      - threads
      - broadcastChannels
      - fundraisers
      type: object
    InstagramProfileSummary:
      $ref: '#/components/schemas/InstagramProfile'
    InstagramProfileThreads:
      additionalProperties: false
      properties:
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        isActive:
          type:
          - boolean
          - 'null'
        joinerLabel:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - isActive
      - handle
      - url
      - joinerLabel
      type: object
    InstagramScrubber:
      additionalProperties: false
      properties:
        duration:
          type:
          - number
          - 'null'
        height:
          type:
          - integer
          - 'null'
        maxThumbnailsPerSprite:
          type:
          - integer
          - 'null'
        thumbnailDuration:
          type:
          - number
          - 'null'
        thumbnailHeight:
          type:
          - integer
          - 'null'
        thumbnailWidth:
          type:
          - integer
          - 'null'
        thumbnailsPerRow:
          type:
          - integer
          - 'null'
        thumbnailsPerSprite:
          type:
          - integer
          - 'null'
        urls:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - urls
      - width
      - height
      - thumbnailWidth
      - thumbnailHeight
      - thumbnailsPerRow
      - thumbnailsPerSprite
      - maxThumbnailsPerSprite
      - thumbnailDuration
      - duration
      type: object
    InstagramSearchResult:
      $ref: '#/components/schemas/InstagramPost'
    InstagramSticker:
      additionalProperties: false
      properties:
        audio:
          anyOf:
          - $ref: '#/components/schemas/InstagramAudioReference'
          - type: 'null'
        endTime:
          type:
          - number
          - 'null'
        hashtag:
          anyOf:
          - $ref: '#/components/schemas/InstagramHashtagReference'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isHidden:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        position:
          additionalProperties: false
          properties:
            height:
              type:
              - number
              - 'null'
            rotation:
              type:
              - number
              - 'null'
            width:
              type:
              - number
              - 'null'
            x:
              type:
              - number
              - 'null'
            y:
              type:
              - number
              - 'null'
            z:
              type:
              - number
              - 'null'
          required:
          - x
          - y
          - z
          - width
          - height
          - rotation
          type: object
        post:
          anyOf:
          - $ref: '#/components/schemas/InstagramStickerPost'
          - type: 'null'
        startTime:
          type:
          - number
          - 'null'
        targetMediaId:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        user:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
      required:
      - id
      - type
      - position
      - isHidden
      - isPinned
      - user
      - post
      - targetMediaId
      - startTime
      - endTime
      - audio
      - url
      - title
      - hashtag
      type: object
    InstagramStickerPost:
      additionalProperties: false
      properties:
        code:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        mediaType:
          minLength: 1
          type:
          - string
          - 'null'
        productType:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - code
      - mediaType
      - productType
      - url
      type: object
    InstagramStory:
      additionalProperties: false
      properties:
        ai:
          additionalProperties: false
          properties:
            detectionMethod:
              minLength: 1
              type:
              - string
              - 'null'
            label:
              additionalProperties: false
              properties:
                detectionMethod:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                isSelfDisclosed:
                  type:
                  - boolean
                  - 'null'
                subtitle:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                text:
                  minLength: 1
                  type:
                  - string
                  - 'null'
              required:
              - text
              - subtitle
              - detectionMethod
              - isSelfDisclosed
              type: object
          required:
          - detectionMethod
          - label
          type: object
        attribution:
          additionalProperties: false
          properties:
            originalPost:
              anyOf:
              - $ref: '#/components/schemas/InstagramPostReference'
              - type: 'null'
          required:
          - originalPost
          type: object
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        caption:
          anyOf:
          - $ref: '#/components/schemas/InstagramCommentReference'
          - type: 'null'
        carousel:
          additionalProperties: false
          properties:
            itemCount:
              type:
              - integer
              - 'null'
            pendingItemCount:
              type:
              - integer
              - 'null'
            previousSubmitters:
              items:
                $ref: '#/components/schemas/InstagramProfileReference'
              type:
              - array
              - 'null'
            submissionState:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - itemCount
          - pendingItemCount
          - submissionState
          - previousSubmitters
          type: object
        code:
          minLength: 1
          type:
          - string
          - 'null'
        collaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        comments:
          $ref: '#/components/schemas/InstagramCommentSettings'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        crossposting:
          additionalProperties: false
          properties:
            isFeedbackAggregated:
              type:
              - boolean
              - 'null'
            isSharedToFacebook:
              type:
              - boolean
              - 'null'
          required:
          - isSharedToFacebook
          - isFeedbackAggregated
          type: object
        expiresAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        hasDelayedMetadata:
          type:
          - boolean
          - 'null'
        hasTaggedUsers:
          type:
          - boolean
          - 'null'
        hasVisualReplies:
          type:
          - boolean
          - 'null'
        highlights:
          items:
            $ref: '#/components/schemas/InstagramHighlightReference'
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type: string
        invitedCollaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        isEarlyAccess:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isFanClubPromo:
          type:
          - boolean
          - 'null'
        isLastVideoSegment:
          type:
          - boolean
          - 'null'
        isOpenToPublicSubmission:
          type:
          - boolean
          - 'null'
        isPaidPartnership:
          type:
          - boolean
          - 'null'
        isPublicChatWelcomeVideo:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        likeAndViewCountsHidden:
          type:
          - boolean
          - 'null'
        location:
          anyOf:
          - $ref: '#/components/schemas/InstagramLocationReference'
          - type: 'null'
        media:
          items:
            $ref: '#/components/schemas/InstagramMedia'
          type: array
        metrics:
          $ref: '#/components/schemas/InstagramPostMetrics'
        notes:
          items:
            $ref: '#/components/schemas/InstagramNote'
          type:
          - array
          - 'null'
        pinning:
          additionalProperties: false
          properties:
            profileUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
            reelsUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
          required:
          - profileUserIds
          - reelsUserIds
          type: object
        productTags:
          items:
            $ref: '#/components/schemas/InstagramProductTag'
          type:
          - array
          - 'null'
        remix:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            carouselRemixesAllowed:
              type:
              - boolean
              - 'null'
            crosspostingAllowed:
              type:
              - boolean
              - 'null'
            hasBeenRemixed:
              type:
              - boolean
              - 'null'
            isRequestingRemixes:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - carouselRemixesAllowed
          - hasBeenRemixed
          - isRequestingRemixes
          - crosspostingAllowed
          type: object
        reuse:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            cutoutStickersAllowed:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - cutoutStickersAllowed
          type: object
        shareCountHidden:
          type:
          - boolean
          - 'null'
        sharingEnabled:
          type:
          - boolean
          - 'null'
        stickers:
          items:
            $ref: '#/components/schemas/InstagramSticker'
          type:
          - array
          - 'null'
        taggedUsers:
          items:
            $ref: '#/components/schemas/InstagramUserTag'
          type:
          - array
          - 'null'
        template:
          anyOf:
          - $ref: '#/components/schemas/InstagramTemplateInfo'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - code
      - fbid
      - type
      - url
      - title
      - text
      - createdAt
      - author
      - caption
      - media
      - metrics
      - comments
      - taggedUsers
      - productTags
      - collaborators
      - invitedCollaborators
      - location
      - isPaidPartnership
      - isEarlyAccess
      - likeAndViewCountsHidden
      - shareCountHidden
      - hasVisualReplies
      - hasDelayedMetadata
      - language
      - hasTaggedUsers
      - isOpenToPublicSubmission
      - sharingEnabled
      - isFanClubPromo
      - isPublicChatWelcomeVideo
      - reuse
      - remix
      - pinning
      - carousel
      - ai
      - notes
      - crossposting
      - attribution
      - template
      - expiresAt
      - isEdited
      - isLastVideoSegment
      - stickers
      - highlights
      type: object
    InstagramStoryCollection:
      additionalProperties: false
      properties:
        audience:
          additionalProperties: false
          properties:
            hasCloseFriendsStories:
              type:
              - boolean
              - 'null'
            hasSubscriberStories:
              type:
              - boolean
              - 'null'
          required:
          - hasCloseFriendsStories
          - hasSubscriberStories
          type: object
        expiresAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isArchived:
          type:
          - boolean
          - 'null'
        lastStoryAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            stories:
              type:
              - integer
              - 'null'
          required:
          - stories
          type: object
      required:
      - id
      - lastStoryAt
      - expiresAt
      - isArchived
      - metrics
      - audience
      type: object
    InstagramStoryReference:
      additionalProperties: false
      properties:
        ai:
          additionalProperties: false
          properties:
            detectionMethod:
              minLength: 1
              type:
              - string
              - 'null'
            label:
              additionalProperties: false
              properties:
                detectionMethod:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                isSelfDisclosed:
                  type:
                  - boolean
                  - 'null'
                subtitle:
                  minLength: 1
                  type:
                  - string
                  - 'null'
                text:
                  minLength: 1
                  type:
                  - string
                  - 'null'
              required:
              - text
              - subtitle
              - detectionMethod
              - isSelfDisclosed
              type: object
          required:
          - detectionMethod
          - label
          type: object
        attribution:
          additionalProperties: false
          properties:
            originalPost:
              anyOf:
              - $ref: '#/components/schemas/InstagramPostReference'
              - type: 'null'
          required:
          - originalPost
          type: object
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        caption:
          anyOf:
          - $ref: '#/components/schemas/InstagramCommentReference'
          - type: 'null'
        carousel:
          additionalProperties: false
          properties:
            itemCount:
              type:
              - integer
              - 'null'
            pendingItemCount:
              type:
              - integer
              - 'null'
            previousSubmitters:
              items:
                $ref: '#/components/schemas/InstagramProfileReference'
              type:
              - array
              - 'null'
            submissionState:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - itemCount
          - pendingItemCount
          - submissionState
          - previousSubmitters
          type: object
        code:
          minLength: 1
          type:
          - string
          - 'null'
        collaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        comments:
          $ref: '#/components/schemas/InstagramCommentSettings'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        crossposting:
          additionalProperties: false
          properties:
            isFeedbackAggregated:
              type:
              - boolean
              - 'null'
            isSharedToFacebook:
              type:
              - boolean
              - 'null'
          required:
          - isSharedToFacebook
          - isFeedbackAggregated
          type: object
        expiresAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        fbid:
          minLength: 1
          type:
          - string
          - 'null'
        hasDelayedMetadata:
          type:
          - boolean
          - 'null'
        hasTaggedUsers:
          type:
          - boolean
          - 'null'
        hasVisualReplies:
          type:
          - boolean
          - 'null'
        highlights:
          items:
            $ref: '#/components/schemas/InstagramHighlightReference'
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        invitedCollaborators:
          items:
            $ref: '#/components/schemas/InstagramProfileReference'
          type:
          - array
          - 'null'
        isEarlyAccess:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isFanClubPromo:
          type:
          - boolean
          - 'null'
        isLastVideoSegment:
          type:
          - boolean
          - 'null'
        isOpenToPublicSubmission:
          type:
          - boolean
          - 'null'
        isPaidPartnership:
          type:
          - boolean
          - 'null'
        isPublicChatWelcomeVideo:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        likeAndViewCountsHidden:
          type:
          - boolean
          - 'null'
        location:
          anyOf:
          - $ref: '#/components/schemas/InstagramLocationReference'
          - type: 'null'
        media:
          items:
            $ref: '#/components/schemas/InstagramMedia'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/InstagramPostMetrics'
        notes:
          items:
            $ref: '#/components/schemas/InstagramNote'
          type:
          - array
          - 'null'
        pinning:
          additionalProperties: false
          properties:
            profileUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
            reelsUserIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
          required:
          - profileUserIds
          - reelsUserIds
          type: object
        productTags:
          items:
            $ref: '#/components/schemas/InstagramProductTag'
          type:
          - array
          - 'null'
        remix:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            carouselRemixesAllowed:
              type:
              - boolean
              - 'null'
            crosspostingAllowed:
              type:
              - boolean
              - 'null'
            hasBeenRemixed:
              type:
              - boolean
              - 'null'
            isRequestingRemixes:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - carouselRemixesAllowed
          - hasBeenRemixed
          - isRequestingRemixes
          - crosspostingAllowed
          type: object
        reuse:
          additionalProperties: false
          properties:
            allowed:
              type:
              - boolean
              - 'null'
            cutoutStickersAllowed:
              type:
              - boolean
              - 'null'
          required:
          - allowed
          - cutoutStickersAllowed
          type: object
        shareCountHidden:
          type:
          - boolean
          - 'null'
        sharingEnabled:
          type:
          - boolean
          - 'null'
        stickers:
          items:
            $ref: '#/components/schemas/InstagramSticker'
          type:
          - array
          - 'null'
        taggedUsers:
          items:
            $ref: '#/components/schemas/InstagramUserTag'
          type:
          - array
          - 'null'
        template:
          anyOf:
          - $ref: '#/components/schemas/InstagramTemplateInfo'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - code
      - fbid
      - type
      - url
      - title
      - text
      - createdAt
      - author
      - caption
      - media
      - metrics
      - comments
      - taggedUsers
      - productTags
      - collaborators
      - invitedCollaborators
      - location
      - isPaidPartnership
      - isEarlyAccess
      - likeAndViewCountsHidden
      - shareCountHidden
      - hasVisualReplies
      - hasDelayedMetadata
      - language
      - hasTaggedUsers
      - isOpenToPublicSubmission
      - sharingEnabled
      - isFanClubPromo
      - isPublicChatWelcomeVideo
      - reuse
      - remix
      - pinning
      - carousel
      - ai
      - notes
      - crossposting
      - attribution
      - template
      - expiresAt
      - isEdited
      - isLastVideoSegment
      - stickers
      - highlights
      type: object
    InstagramStreamVariant:
      additionalProperties: false
      properties:
        bitrate:
          type:
          - integer
          - 'null'
        codec:
          minLength: 1
          type:
          - string
          - 'null'
        frameRate:
          type:
          - number
          - 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        mimeType:
          minLength: 1
          type:
          - string
          - 'null'
        qualityLabel:
          minLength: 1
          type:
          - string
          - 'null'
        sampleRate:
          type:
          - integer
          - 'null'
        sizeBytes:
          type:
          - integer
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - id
      - url
      - codec
      - mimeType
      - qualityLabel
      - width
      - height
      - bitrate
      - sizeBytes
      - sampleRate
      - frameRate
      type: object
    InstagramStreaming:
      additionalProperties: false
      properties:
        dash:
          anyOf:
          - $ref: '#/components/schemas/InstagramDASH'
          - type: 'null'
      required:
      - dash
      type: object
    InstagramSubtitles:
      additionalProperties: false
      properties:
        confidence:
          type:
          - number
          - 'null'
        enabled:
          type:
          - boolean
          - 'null'
        generated:
          type:
          - boolean
          - 'null'
        locale:
          minLength: 1
          type:
          - string
          - 'null'
        status:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - enabled
      - generated
      - status
      - locale
      - confidence
      - url
      type: object
    InstagramSuggestion:
      additionalProperties: false
      properties:
        caption:
          minLength: 1
          type:
          - string
          - 'null'
        hasStoryRing:
          type:
          - boolean
          - 'null'
        icon:
          minLength: 1
          type:
          - string
          - 'null'
        isNew:
          type:
          - boolean
          - 'null'
        largeImages:
          items:
            $ref: '#/components/schemas/InstagramImage'
          type:
          - array
          - 'null'
        posts:
          items:
            $ref: '#/components/schemas/InstagramPostReference'
          type:
          - array
          - 'null'
        socialContext:
          minLength: 1
          type:
          - string
          - 'null'
        thumbnails:
          items:
            $ref: '#/components/schemas/InstagramImage'
          type:
          - array
          - 'null'
      required:
      - socialContext
      - hasStoryRing
      - isNew
      - icon
      - caption
      - thumbnails
      - largeImages
      - posts
      type: object
    InstagramTemplate:
      additionalProperties: false
      properties:
        audioTitle:
          minLength: 1
          type:
          - string
          - 'null'
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        effectId:
          minLength: 1
          type:
          - string
          - 'null'
        effects:
          additionalProperties: false
          properties:
            segments:
              items: {}
              type:
              - array
              - 'null'
          required:
          - segments
          type: object
        minimumSegments:
          type:
          - integer
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        posts:
          items:
            $ref: '#/components/schemas/InstagramPostReference'
          type:
          - array
          - 'null'
        segments:
          items:
            $ref: '#/components/schemas/InstagramTemplateSegment'
          type:
          - array
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        usageLabel:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - postId
      - author
      - minimumSegments
      - segments
      - effectId
      - effects
      - title
      - audioTitle
      - usageLabel
      - posts
      type: object
    InstagramTemplateInfo:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/InstagramProfileReference'
          - type: 'null'
        effectId:
          minLength: 1
          type:
          - string
          - 'null'
        effects:
          additionalProperties: false
          properties:
            segments:
              items: {}
              type:
              - array
              - 'null'
          required:
          - segments
          type: object
        minimumSegments:
          type:
          - integer
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        segments:
          items:
            $ref: '#/components/schemas/InstagramTemplateSegment'
          type:
          - array
          - 'null'
      required:
      - postId
      - author
      - minimumSegments
      - segments
      - effectId
      - effects
      type: object
    InstagramTemplateSegment:
      additionalProperties: false
      properties:
        assetEndTime:
          type:
          - number
          - 'null'
        assetStartTime:
          type:
          - number
          - 'null'
        duration:
          type:
          - number
          - 'null'
      required:
      - duration
      - assetStartTime
      - assetEndTime
      type: object
    InstagramUserTag:
      additionalProperties: false
      properties:
        position:
          $ref: '#/components/schemas/InstagramPosition'
        user:
          $ref: '#/components/schemas/InstagramProfileReference'
      required:
      - user
      - position
      type: object
    MessageEnvelope:
      additionalProperties: false
      properties:
        message:
          minLength: 1
          type: string
      required:
      - message
      type: object
    RedditAuthor:
      additionalProperties: false
      properties:
        flair:
          anyOf:
          - $ref: '#/components/schemas/RedditFlair'
          - type: 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isPremium:
          type:
          - boolean
          - 'null'
        placeholder:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - handle
      - placeholder
      - isPremium
      - flair
      type: object
    RedditComment:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/RedditAuthor'
          - type: 'null'
        community:
          anyOf:
          - $ref: '#/components/schemas/RedditCommunity'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        depth:
          type:
          - integer
          - 'null'
        display:
          $ref: '#/components/schemas/RedditCommentDisplay'
        distinguishedBy:
          minLength: 1
          type:
          - string
          - 'null'
        editedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        isArchived:
          type:
          - boolean
          - 'null'
        isByPostAuthor:
          type:
          - boolean
          - 'null'
        isControversial:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isLocked:
          type:
          - boolean
          - 'null'
        isStickied:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/RedditCommentMetrics'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        replies:
          items:
            $ref: '#/components/schemas/RedditCommentReference'
          type:
          - array
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        textHtml:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
        visibility:
          $ref: '#/components/schemas/RedditCommentVisibility'
      required:
      - id
      - text
      - textHtml
      - author
      - community
      - postId
      - parentId
      - url
      - metrics
      - visibility
      - isByPostAuthor
      - isStickied
      - isLocked
      - isArchived
      - distinguishedBy
      - type
      - display
      - createdAt
      - isEdited
      - editedAt
      - isControversial
      - depth
      - replies
      type: object
    RedditCommentDisplay:
      additionalProperties: false
      properties:
        collapsedReason:
          minLength: 1
          type:
          - string
          - 'null'
        isCollapsed:
          type:
          - boolean
          - 'null'
      required:
      - isCollapsed
      - collapsedReason
      type: object
    RedditCommentMetrics:
      additionalProperties: false
      properties:
        awards:
          type:
          - integer
          - 'null'
        gilded:
          type:
          - integer
          - 'null'
        score:
          type:
          - integer
          - 'null'
      required:
      - score
      - awards
      - gilded
      type: object
    RedditCommentReference:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/RedditAuthor'
          - type: 'null'
        community:
          anyOf:
          - $ref: '#/components/schemas/RedditCommunity'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        depth:
          type:
          - integer
          - 'null'
        display:
          $ref: '#/components/schemas/RedditCommentDisplay'
        distinguishedBy:
          minLength: 1
          type:
          - string
          - 'null'
        editedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isArchived:
          type:
          - boolean
          - 'null'
        isByPostAuthor:
          type:
          - boolean
          - 'null'
        isControversial:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isLocked:
          type:
          - boolean
          - 'null'
        isStickied:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/RedditCommentMetrics'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        replies:
          items:
            $ref: '#/components/schemas/RedditCommentReference'
          type:
          - array
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        textHtml:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        visibility:
          $ref: '#/components/schemas/RedditCommentVisibility'
      required:
      - id
      - text
      - textHtml
      - author
      - community
      - postId
      - parentId
      - url
      - metrics
      - visibility
      - isByPostAuthor
      - isStickied
      - isLocked
      - isArchived
      - distinguishedBy
      - type
      - display
      - createdAt
      - isEdited
      - editedAt
      - isControversial
      - depth
      - replies
      type: object
    RedditCommentSettings:
      additionalProperties: false
      properties:
        restrictCommenting:
          type:
          - boolean
          - 'null'
        scoreHideDuration:
          type:
          - integer
          - 'null'
        suggestedSort:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - restrictCommenting
      - suggestedSort
      - scoreHideDuration
      type: object
    RedditCommentVisibility:
      additionalProperties: false
      properties:
        isScoreHidden:
          type:
          - boolean
          - 'null'
      required:
      - isScoreHidden
      type: object
    RedditCommentsSetting:
      additionalProperties: false
      properties:
        allowLiveComments:
          type:
          - boolean
          - 'null'
        discussionType:
          minLength: 1
          type:
          - string
          - 'null'
        isContestMode:
          type:
          - boolean
          - 'null'
        suggestedSort:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - isContestMode
      - allowLiveComments
      - suggestedSort
      - discussionType
      type: object
    RedditCommunity:
      additionalProperties: false
      properties:
        displayHandle:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isQuarantined:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/RedditSubredditMetrics'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - handle
      - displayHandle
      - type
      - metrics
      - isQuarantined
      type: object
    RedditCommunityHandle:
      additionalProperties: false
      properties:
        handle:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - handle
      type: object
    RedditDisplaySettings:
      additionalProperties: false
      properties:
        showMedia:
          type:
          - boolean
          - 'null'
      required:
      - showMedia
      type: object
    RedditEmbed:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/RedditEmbedAuthor'
          - type: 'null'
        domain:
          minLength: 1
          type:
          - string
          - 'null'
        height:
          type:
          - integer
          - 'null'
        html:
          minLength: 1
          type:
          - string
          - 'null'
        mediaDomainUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        provider:
          anyOf:
          - $ref: '#/components/schemas/RedditEmbedSource'
          - type: 'null'
        scrolling:
          type:
          - boolean
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/RedditThumbnail'
          - type: 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        version:
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - domain
      - version
      - title
      - type
      - html
      - height
      - width
      - provider
      - author
      - thumbnail
      - scrolling
      - mediaDomainUrl
      type: object
    RedditEmbedAuthor:
      additionalProperties: false
      properties:
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - displayName
      - url
      type: object
    RedditEmbedSource:
      additionalProperties: false
      properties:
        name:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - name
      - url
      type: object
    RedditFlair:
      additionalProperties: false
      properties:
        backgroundColor:
          minLength: 1
          type:
          - string
          - 'null'
        cssClass:
          minLength: 1
          type:
          - string
          - 'null'
        hasPatreonFlair:
          type:
          - boolean
          - 'null'
        templateId:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        textColor:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      - type
      - templateId
      - cssClass
      - backgroundColor
      - textColor
      - hasPatreonFlair
      type: object
    RedditImage:
      additionalProperties: false
      properties:
        height:
          type:
          - integer
          - 'null'
        label:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/RedditImage'
          type:
          - array
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - type
      - url
      - label
      - width
      - height
      - variants
      type: object
    RedditKarma:
      additionalProperties: false
      properties:
        awardee:
          type:
          - integer
          - 'null'
        awarder:
          type:
          - integer
          - 'null'
        comments:
          type:
          - integer
          - 'null'
        posts:
          type:
          - integer
          - 'null'
        total:
          type:
          - integer
          - 'null'
      required:
      - posts
      - comments
      - awardee
      - awarder
      - total
      type: object
    RedditListingContext:
      additionalProperties: false
      properties:
        originalPost:
          anyOf:
          - $ref: '#/components/schemas/RedditPostReference'
          - type: 'null'
        post:
          anyOf:
          - $ref: '#/components/schemas/RedditPostReference'
          - type: 'null'
      required:
      - post
      - originalPost
      type: object
    RedditMedia:
      additionalProperties: false
      properties:
        bitrateKbps:
          type:
          - integer
          - 'null'
        caption:
          minLength: 1
          type:
          - string
          - 'null'
        duration:
          type:
          - number
          - 'null'
        hasAudio:
          type:
          - boolean
          - 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAnimated:
          type:
          - boolean
          - 'null'
        mimeType:
          minLength: 1
          type:
          - string
          - 'null'
        scrubber:
          anyOf:
          - $ref: '#/components/schemas/RedditMediaVariant'
          - type: 'null'
        transcodingStatus:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/RedditMediaVariant'
          type:
          - array
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - type
      - id
      - width
      - height
      - mimeType
      - caption
      - url
      - variants
      - bitrateKbps
      - hasAudio
      - duration
      - isAnimated
      - transcodingStatus
      - scrubber
      type: object
    RedditMediaVariant:
      additionalProperties: false
      properties:
        format:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - format
      - type
      - url
      type: object
    RedditPageMetadata:
      additionalProperties: false
      properties:
        community:
          anyOf:
          - $ref: '#/components/schemas/RedditCommunityHandle'
          - type: 'null'
        context:
          anyOf:
          - $ref: '#/components/schemas/RedditListingContext'
          - type: 'null'
        count:
          type:
          - integer
          - 'null'
        domain:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        hasMore:
          type:
          - boolean
          - 'null'
        limit:
          type:
          - integer
          - 'null'
        previousCursor:
          minLength: 1
          type:
          - string
          - 'null'
        query:
          minLength: 1
          type:
          - string
          - 'null'
        siteRules:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        sort:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - count
      - limit
      - hasMore
      - previousCursor
      - query
      - sort
      - domain
      - handle
      - community
      - siteRules
      - context
      type: object
    RedditPost:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/RedditAuthor'
          - type: 'null'
        comments:
          $ref: '#/components/schemas/RedditCommentsSetting'
        community:
          anyOf:
          - $ref: '#/components/schemas/RedditCommunity'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        distinguishedBy:
          minLength: 1
          type:
          - string
          - 'null'
        domain:
          minLength: 1
          type:
          - string
          - 'null'
        editedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        embed:
          anyOf:
          - $ref: '#/components/schemas/RedditEmbed'
          - type: 'null'
        flair:
          anyOf:
          - $ref: '#/components/schemas/RedditFlair'
          - type: 'null'
        id:
          minLength: 1
          type: string
        isArchived:
          type:
          - boolean
          - 'null'
        isCrosspostable:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isGallery:
          type:
          - boolean
          - 'null'
        isLocked:
          type:
          - boolean
          - 'null'
        isMediaOnly:
          type:
          - boolean
          - 'null'
        isMeta:
          type:
          - boolean
          - 'null'
        isOriginalContent:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        isRedditMediaDomain:
          type:
          - boolean
          - 'null'
        isSelf:
          type:
          - boolean
          - 'null'
        isSensitive:
          type:
          - boolean
          - 'null'
        isSpoiler:
          type:
          - boolean
          - 'null'
        isStickied:
          type:
          - boolean
          - 'null'
        isVideo:
          type:
          - boolean
          - 'null'
        linkUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/RedditMedia'
          type: array
        metrics:
          $ref: '#/components/schemas/RedditPostMetrics'
        removedByCategory:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        textHtml:
          minLength: 1
          type:
          - string
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/RedditThumbnail'
          - type: 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        topAwardedType:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
        visibility:
          $ref: '#/components/schemas/RedditPostVisibility'
      required:
      - id
      - title
      - text
      - textHtml
      - domain
      - url
      - linkUrl
      - author
      - community
      - metrics
      - createdAt
      - isEdited
      - editedAt
      - isSelf
      - isVideo
      - isGallery
      - isMeta
      - isOriginalContent
      - isCrosspostable
      - isRedditMediaDomain
      - isMediaOnly
      - isSensitive
      - isSpoiler
      - isStickied
      - isLocked
      - isArchived
      - isPinned
      - visibility
      - comments
      - distinguishedBy
      - removedByCategory
      - topAwardedType
      - flair
      - thumbnail
      - media
      - embed
      type: object
    RedditPostFlairSettings:
      additionalProperties: false
      properties:
        enabled:
          type:
          - boolean
          - 'null'
        position:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - enabled
      - position
      type: object
    RedditPostMetrics:
      additionalProperties: false
      properties:
        awards:
          type:
          - integer
          - 'null'
        comments:
          type:
          - integer
          - 'null'
        crossposts:
          type:
          - integer
          - 'null'
        gilded:
          type:
          - integer
          - 'null'
        score:
          type:
          - integer
          - 'null'
        upvoteRatio:
          type:
          - number
          - 'null'
        views:
          type:
          - integer
          - 'null'
      required:
      - score
      - upvoteRatio
      - comments
      - crossposts
      - awards
      - gilded
      - views
      type: object
    RedditPostReference:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/RedditAuthor'
          - type: 'null'
        comments:
          $ref: '#/components/schemas/RedditCommentsSetting'
        community:
          anyOf:
          - $ref: '#/components/schemas/RedditCommunity'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        distinguishedBy:
          minLength: 1
          type:
          - string
          - 'null'
        domain:
          minLength: 1
          type:
          - string
          - 'null'
        editedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        embed:
          anyOf:
          - $ref: '#/components/schemas/RedditEmbed'
          - type: 'null'
        flair:
          anyOf:
          - $ref: '#/components/schemas/RedditFlair'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isArchived:
          type:
          - boolean
          - 'null'
        isCrosspostable:
          type:
          - boolean
          - 'null'
        isEdited:
          type:
          - boolean
          - 'null'
        isGallery:
          type:
          - boolean
          - 'null'
        isLocked:
          type:
          - boolean
          - 'null'
        isMediaOnly:
          type:
          - boolean
          - 'null'
        isMeta:
          type:
          - boolean
          - 'null'
        isOriginalContent:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        isRedditMediaDomain:
          type:
          - boolean
          - 'null'
        isSelf:
          type:
          - boolean
          - 'null'
        isSensitive:
          type:
          - boolean
          - 'null'
        isSpoiler:
          type:
          - boolean
          - 'null'
        isStickied:
          type:
          - boolean
          - 'null'
        isVideo:
          type:
          - boolean
          - 'null'
        linkUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/RedditMedia'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/RedditPostMetrics'
        removedByCategory:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        textHtml:
          minLength: 1
          type:
          - string
          - 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/RedditThumbnail'
          - type: 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        topAwardedType:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        visibility:
          $ref: '#/components/schemas/RedditPostVisibility'
      required:
      - id
      - title
      - text
      - textHtml
      - domain
      - url
      - linkUrl
      - author
      - community
      - metrics
      - createdAt
      - isEdited
      - editedAt
      - isSelf
      - isVideo
      - isGallery
      - isMeta
      - isOriginalContent
      - isCrosspostable
      - isRedditMediaDomain
      - isMediaOnly
      - isSensitive
      - isSpoiler
      - isStickied
      - isLocked
      - isArchived
      - isPinned
      - visibility
      - comments
      - distinguishedBy
      - removedByCategory
      - topAwardedType
      - flair
      - thumbnail
      - media
      - embed
      type: object
    RedditPostVisibility:
      additionalProperties: false
      properties:
        isRobotIndexable:
          type:
          - boolean
          - 'null'
        isScoreHidden:
          type:
          - boolean
          - 'null'
      required:
      - isRobotIndexable
      - isScoreHidden
      type: object
    RedditPostingLabels:
      additionalProperties: false
      properties:
        link:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      - link
      type: object
    RedditPostingSettings:
      additionalProperties: false
      properties:
        allOriginalContent:
          type:
          - boolean
          - 'null'
        allowGalleries:
          type:
          - boolean
          - 'null'
        allowImages:
          type:
          - boolean
          - 'null'
        allowPolls:
          type:
          - boolean
          - 'null'
        allowVideos:
          type:
          - boolean
          - 'null'
        instructions:
          anyOf:
          - $ref: '#/components/schemas/RedditText'
          - type: 'null'
        labels:
          anyOf:
          - $ref: '#/components/schemas/RedditPostingLabels'
          - type: 'null'
        originalContentTagEnabled:
          type:
          - boolean
          - 'null'
        restrictPosting:
          type:
          - boolean
          - 'null'
        spoilersEnabled:
          type:
          - boolean
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - type
      - instructions
      - labels
      - allowImages
      - allowVideos
      - allowGalleries
      - allowPolls
      - spoilersEnabled
      - originalContentTagEnabled
      - allOriginalContent
      - restrictPosting
      type: object
    RedditProfile:
      additionalProperties: false
      properties:
        acceptsFollowers:
          type:
          - boolean
          - 'null'
        avatar:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        banner:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        displayHandle:
          minLength: 1
          type:
          - string
          - 'null'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type: string
        id:
          minLength: 1
          type: string
        isEmployee:
          type:
          - boolean
          - 'null'
        isModerator:
          type:
          - boolean
          - 'null'
        isPremium:
          type:
          - boolean
          - 'null'
        isSensitive:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/RedditProfileMetrics'
        profileCommunity:
          anyOf:
          - $ref: '#/components/schemas/RedditProfileCommunity'
          - type: 'null'
        snoovatar:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        url:
          format: uri
          minLength: 1
          type: string
        verification:
          $ref: '#/components/schemas/RedditVerification'
        visibility:
          $ref: '#/components/schemas/RedditProfileVisibility'
      required:
      - id
      - handle
      - displayHandle
      - displayName
      - bio
      - url
      - createdAt
      - avatar
      - snoovatar
      - banner
      - isPremium
      - isEmployee
      - isModerator
      - acceptsFollowers
      - isSensitive
      - verification
      - visibility
      - metrics
      - profileCommunity
      type: object
    RedditProfileCommunity:
      additionalProperties: false
      properties:
        communityIcon:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        displayHandle:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        icon:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        primaryColor:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - handle
      - type
      - displayHandle
      - icon
      - communityIcon
      - primaryColor
      type: object
    RedditProfileMetrics:
      additionalProperties: false
      properties:
        followers:
          type:
          - integer
          - 'null'
        karma:
          $ref: '#/components/schemas/RedditKarma'
      required:
      - followers
      - karma
      type: object
    RedditProfileVisibility:
      additionalProperties: false
      properties:
        hideFromRobots:
          type:
          - boolean
          - 'null'
      required:
      - hideFromRobots
      type: object
    RedditReportSettings:
      additionalProperties: false
      properties:
        allowCustomReasons:
          type:
          - boolean
          - 'null'
      required:
      - allowCustomReasons
      type: object
    RedditRule:
      additionalProperties: false
      properties:
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        description:
          anyOf:
          - $ref: '#/components/schemas/RedditText'
          - type: 'null'
        kind:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type: string
        priority:
          type:
          - integer
          - 'null'
        violationReason:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - priority
      - name
      - violationReason
      - kind
      - description
      - createdAt
      type: object
    RedditSubreddit:
      additionalProperties: false
      properties:
        acceptsFollowers:
          type:
          - boolean
          - 'null'
        avatar:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        banner:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        branding:
          $ref: '#/components/schemas/RedditSubredditBranding'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        description:
          anyOf:
          - $ref: '#/components/schemas/RedditText'
          - type: 'null'
        displayHandle:
          minLength: 1
          type:
          - string
          - 'null'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type: string
        id:
          minLength: 1
          type: string
        isQuarantined:
          type:
          - boolean
          - 'null'
        isSensitive:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/RedditSubredditMetrics'
        settings:
          $ref: '#/components/schemas/RedditSubredditSettings'
        summary:
          anyOf:
          - $ref: '#/components/schemas/RedditText'
          - type: 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - handle
      - displayHandle
      - displayName
      - type
      - language
      - url
      - createdAt
      - isQuarantined
      - isSensitive
      - acceptsFollowers
      - metrics
      - description
      - summary
      - settings
      - branding
      - avatar
      - banner
      type: object
    RedditSubredditBranding:
      additionalProperties: false
      properties:
        banner:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        colors:
          $ref: '#/components/schemas/RedditSubredditColors'
        header:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        headerTitle:
          minLength: 1
          type:
          - string
          - 'null'
        icon:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
      required:
      - headerTitle
      - colors
      - icon
      - banner
      - header
      type: object
    RedditSubredditColors:
      additionalProperties: false
      properties:
        bannerBackground:
          minLength: 1
          type:
          - string
          - 'null'
        key:
          minLength: 1
          type:
          - string
          - 'null'
        primary:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - primary
      - key
      - bannerBackground
      type: object
    RedditSubredditMetrics:
      additionalProperties: false
      properties:
        subscribers:
          type:
          - integer
          - 'null'
      required:
      - subscribers
      type: object
    RedditSubredditSettings:
      additionalProperties: false
      properties:
        comments:
          $ref: '#/components/schemas/RedditCommentSettings'
        display:
          $ref: '#/components/schemas/RedditDisplaySettings'
        postFlair:
          $ref: '#/components/schemas/RedditPostFlairSettings'
        posting:
          $ref: '#/components/schemas/RedditPostingSettings'
        reports:
          $ref: '#/components/schemas/RedditReportSettings'
      required:
      - posting
      - comments
      - reports
      - display
      - postFlair
      type: object
    RedditText:
      additionalProperties: false
      properties:
        html:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      - html
      type: object
    RedditThumbnail:
      additionalProperties: false
      properties:
        height:
          type:
          - integer
          - 'null'
        state:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - type
      - url
      - state
      - width
      - height
      type: object
    RedditTrophy:
      additionalProperties: false
      properties:
        awardId:
          minLength: 1
          type:
          - string
          - 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        grantedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        icon:
          anyOf:
          - $ref: '#/components/schemas/RedditImage'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type: string
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - awardId
      - name
      - description
      - url
      - grantedAt
      - icon
      type: object
    RedditVerification:
      additionalProperties: false
      properties:
        hasVerifiedEmail:
          type:
          - boolean
          - 'null'
        reportedVerified:
          type:
          - boolean
          - 'null'
      required:
      - reportedVerified
      - hasVerifiedEmail
      type: object
    RedditWikiAuthor:
      additionalProperties: false
      properties:
        handle:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - handle
      type: object
    RedditWikiContent:
      additionalProperties: false
      properties:
        html:
          minLength: 1
          type:
          - string
          - 'null'
        markdown:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - markdown
      - html
      type: object
    RedditWikiPage:
      additionalProperties: false
      properties:
        content:
          anyOf:
          - $ref: '#/components/schemas/RedditWikiContent'
          - type: 'null'
        revision:
          anyOf:
          - $ref: '#/components/schemas/RedditWikiRevision'
          - type: 'null'
        title:
          minLength: 1
          type: string
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - title
      - url
      - content
      - revision
      type: object
    RedditWikiRevision:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/RedditWikiAuthor'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        reason:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - reason
      - author
      - createdAt
      type: object
    ResponseCursors:
      properties:
        next:
          type:
          - string
          - 'null'
      required:
      - next
      type: object
    ResponseMeta:
      properties:
        cashtags:
          items: {}
          type:
          - array
          - 'null'
        chart:
          anyOf:
          - $ref: '#/components/schemas/TikTokChartMetadata'
          - type: 'null'
        collection:
          anyOf:
          - $ref: '#/components/schemas/InstagramStoryCollection'
          - type: 'null'
        community:
          anyOf:
          - $ref: '#/components/schemas/RedditCommunityHandle'
          - type: 'null'
        context:
          anyOf:
          - $ref: '#/components/schemas/RedditListingContext'
          - type: 'null'
        continuation:
          anyOf:
          - $ref: '#/components/schemas/TikTokPageContinuation'
          - type: 'null'
        count:
          type:
          - integer
          - 'null'
        cursors:
          $ref: '#/components/schemas/ResponseCursors'
        domain:
          minLength: 1
          type:
          - string
          - 'null'
        events:
          items: {}
          type:
          - array
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        hasFilteredComments:
          type:
          - boolean
          - 'null'
        hasMore:
          type:
          - boolean
          - 'null'
        hasMoreAfter:
          type:
          - boolean
          - 'null'
        hasMoreBefore:
          type:
          - boolean
          - 'null'
        hashtags:
          items: {}
          type:
          - array
          - 'null'
        isLimited:
          type: boolean
        likesEnabled:
          type:
          - boolean
          - 'null'
        limit:
          type:
          - integer
          - 'null'
        lists:
          items: {}
          type:
          - array
          - 'null'
        metrics:
          properties:
            comments:
              type:
              - integer
              - 'null'
            followers:
              type:
              - integer
              - 'null'
            following:
              type:
              - integer
              - 'null'
            likes:
              type:
              - integer
              - 'null'
            replies:
              type:
              - integer
              - 'null'
            results:
              type:
              - integer
              - 'null'
            suggestions:
              type:
              - integer
              - 'null'
          type: object
        nextCursorLabel:
          minLength: 1
          type:
          - string
          - 'null'
        nextCursorType:
          minLength: 1
          type:
          - string
          - 'null'
        parent:
          anyOf:
          - $ref: '#/components/schemas/InstagramCommentReference'
          - type: 'null'
        previousCursor:
          minLength: 1
          type:
          - string
          - 'null'
        promoted:
          items:
            $ref: '#/components/schemas/TwitterPostReference'
          type:
          - array
          - 'null'
        queries:
          items:
            $ref: '#/components/schemas/TwitterSuggestedQuery'
          type:
          - array
          - 'null'
        query:
          minLength: 1
          type:
          - string
          - 'null'
        siteRules:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        sort:
          minLength: 1
          type:
          - string
          - 'null'
        threadingEnabled:
          type:
          - boolean
          - 'null'
        track:
          anyOf:
          - $ref: '#/components/schemas/InstagramAudioReference'
          - type: 'null'
      required:
      - cursors
      type: object
    SuccessEnvelope:
      additionalProperties: false
      properties:
        capturedAt:
          format: date-time
          type: string
        data: {}
        meta:
          $ref: '#/components/schemas/ResponseMeta'
        platform:
          enum:
          - instagram
          - tiktok
          - twitter
          - reddit
          type: string
        resource:
          enum:
          - profile
          - post
          - comment
          - hashtag
          - location
          - music
          - category
          - list
          - entity
          - subreddit
          - rule
          - wiki
          - trophy
          type: string
        source:
          enum:
          - live
          - cache
          type: string
      required:
      - platform
      - resource
      - capturedAt
      - source
      - data
      type: object
    TestDataCatalog:
      additionalProperties: false
      properties:
        changeNotes:
          items:
            type: string
          type: array
        contentHash:
          minLength: 1
          type: string
        datasetVersion:
          minLength: 1
          type: string
        entries:
          items:
            $ref: '#/components/schemas/TestDataEntry'
          type: array
        mediaProvenanceUrl:
          format: uri
          type: string
        operations:
          items:
            $ref: '#/components/schemas/TestDataOperation'
          type: array
        synthetic:
          const: true
          type: boolean
      required:
      - datasetVersion
      - contentHash
      - mediaProvenanceUrl
      - synthetic
      - changeNotes
      - operations
      - entries
      type: object
    TestDataCatalogEnvelope:
      additionalProperties: false
      properties:
        data:
          $ref: '#/components/schemas/TestDataCatalog'
      required:
      - data
      type: object
    TestDataEntry:
      additionalProperties: false
      properties:
        datasetVersion:
          minLength: 1
          type: string
        description:
          minLength: 1
          type: string
        expected:
          $ref: '#/components/schemas/TestDataExpectedResult'
        id:
          minLength: 1
          type: string
        inputs:
          additionalProperties:
            type: string
          type: object
        label:
          minLength: 1
          type: string
        operationIds:
          items:
            minLength: 1
            type: string
          type: array
        platform:
          enum:
          - instagram
          - tiktok
          - twitter
          - reddit
          type: string
        relationships:
          items:
            $ref: '#/components/schemas/TestDataRelationship'
          type: array
        resource:
          enum:
          - profile
          - post
          - comment
          - hashtag
          - location
          - music
          - category
          - list
          - entity
          - subreddit
          - rule
          - wiki
          - trophy
          type: string
        synthetic:
          const: true
          type: boolean
        traits:
          items:
            minLength: 1
            type: string
          type: array
      required:
      - id
      - datasetVersion
      - platform
      - resource
      - label
      - description
      - traits
      - inputs
      - expected
      - relationships
      - operationIds
      - synthetic
      type: object
    TestDataEntryEnvelope:
      additionalProperties: false
      properties:
        data:
          $ref: '#/components/schemas/TestDataEntry'
      required:
      - data
      type: object
    TestDataExpectedResult:
      additionalProperties: false
      properties:
        errorCode:
          minLength: 1
          type: string
        status:
          enum:
          - 200
          - 403
          - 404
          type: integer
      required:
      - status
      type: object
    TestDataOperation:
      additionalProperties: false
      properties:
        description:
          minLength: 1
          type: string
        id:
          minLength: 1
          type: string
        inputFields:
          items:
            minLength: 1
            type: string
          type: array
        locators:
          items:
            minLength: 1
            type: string
          type: array
        method:
          const: GET
          type: string
        paginated:
          type: boolean
        path:
          minLength: 1
          type: string
        platform:
          enum:
          - instagram
          - tiktok
          - twitter
          - reddit
          type: string
        publicSchema:
          minLength: 1
          type: string
        resource:
          enum:
          - profile
          - post
          - comment
          - hashtag
          - location
          - music
          - category
          - list
          - entity
          - subreddit
          - rule
          - wiki
          - trophy
          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
    TikTokAsset:
      additionalProperties: false
      properties:
        bitrate:
          type:
          - integer
          - 'null'
        codecCode:
          type:
          - integer
          - 'null'
        covers:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        duration:
          type:
          - number
          - 'null'
        expiresAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        format:
          minLength: 1
          type:
          - string
          - 'null'
        frameRate:
          type:
          - number
          - 'null'
        hasWatermark:
          type:
          - boolean
          - 'null'
        hash:
          minLength: 1
          type:
          - string
          - 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAutoGenerated:
          type:
          - boolean
          - 'null'
        isBytevc1:
          type:
          - boolean
          - 'null'
        isOriginal:
          type:
          - boolean
          - 'null'
        label:
          minLength: 1
          type:
          - string
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        locale:
          minLength: 1
          type:
          - string
          - 'null'
        previewThumbnails:
          items:
            $ref: '#/components/schemas/TikTokPreviewThumbnails'
          type:
          - array
          - 'null'
        qualityCode:
          type:
          - integer
          - 'null'
        qualityLabel:
          minLength: 1
          type:
          - string
          - 'null'
        renditions:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        role:
          minLength: 1
          type:
          - string
          - 'null'
        size:
          type:
          - integer
          - 'null'
        subtitles:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        version:
          minLength: 1
          type:
          - string
          - 'null'
        volumeInfo:
          $ref: '#/components/schemas/TikTokVolumeInfo'
        width:
          type:
          - integer
          - 'null'
      required:
      - volumeInfo
      - id
      - type
      - url
      - width
      - height
      - size
      - hash
      - role
      - label
      - duration
      - hasWatermark
      - qualityLabel
      - qualityCode
      - bitrate
      - frameRate
      - isBytevc1
      - codecCode
      - format
      - language
      - locale
      - isAutoGenerated
      - isOriginal
      - version
      - expiresAt
      - renditions
      - covers
      - subtitles
      - previewThumbnails
      - variants
      type: object
    TikTokBeatData:
      additionalProperties: false
      properties:
        bitrate:
          type:
          - integer
          - 'null'
        codecCode:
          type:
          - integer
          - 'null'
        covers:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        duration:
          type:
          - number
          - 'null'
        expiresAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        format:
          minLength: 1
          type:
          - string
          - 'null'
        frameRate:
          type:
          - number
          - 'null'
        hasWatermark:
          type:
          - boolean
          - 'null'
        hash:
          minLength: 1
          type:
          - string
          - 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAutoGenerated:
          type:
          - boolean
          - 'null'
        isBytevc1:
          type:
          - boolean
          - 'null'
        isOriginal:
          type:
          - boolean
          - 'null'
        label:
          minLength: 1
          type:
          - string
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        locale:
          minLength: 1
          type:
          - string
          - 'null'
        previewThumbnails:
          items:
            $ref: '#/components/schemas/TikTokPreviewThumbnails'
          type:
          - array
          - 'null'
        qualityCode:
          type:
          - integer
          - 'null'
        qualityLabel:
          minLength: 1
          type:
          - string
          - 'null'
        renditions:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        resources:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        role:
          minLength: 1
          type:
          - string
          - 'null'
        size:
          type:
          - integer
          - 'null'
        subtitles:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        version:
          minLength: 1
          type:
          - string
          - 'null'
        volumeInfo:
          $ref: '#/components/schemas/TikTokVolumeInfo'
        width:
          type:
          - integer
          - 'null'
      required:
      - volumeInfo
      - id
      - type
      - url
      - width
      - height
      - size
      - hash
      - role
      - label
      - duration
      - hasWatermark
      - qualityLabel
      - qualityCode
      - bitrate
      - frameRate
      - isBytevc1
      - codecCode
      - format
      - language
      - locale
      - isAutoGenerated
      - isOriginal
      - version
      - expiresAt
      - renditions
      - covers
      - subtitles
      - previewThumbnails
      - variants
      - resources
      type: object
    TikTokCategory:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        categoryContext:
          $ref: '#/components/schemas/TikTokCategoryContext'
        classification:
          $ref: '#/components/schemas/TikTokHashtagClassification'
        cover:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        isCommerce:
          type:
          - boolean
          - 'null'
        isStrongMusic:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokHashtagMetrics'
        music:
          items:
            $ref: '#/components/schemas/TikTokMusicReference'
          type:
          - array
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        previewPosts:
          items:
            $ref: '#/components/schemas/TikTokPostReference'
          type:
          - array
          - 'null'
        searchContext:
          $ref: '#/components/schemas/TikTokHashtagSearchContext'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - name
      - url
      - description
      - isCommerce
      - isStrongMusic
      - classification
      - metrics
      - avatar
      - cover
      - music
      - searchContext
      - categoryContext
      - previewPosts
      type: object
    TikTokCategoryContext:
      additionalProperties: false
      properties:
        label:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
      required:
      - typeCode
      - label
      type: object
    TikTokChartMetadata:
      additionalProperties: false
      properties:
        cover:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        updatedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - updatedAt
      - cover
      type: object
    TikTokCollaborator:
      additionalProperties: false
      properties:
        profile:
          $ref: '#/components/schemas/TikTokProfileReference'
        status:
          type:
          - integer
          - 'null'
      required:
      - profile
      - status
      type: object
    TikTokComment:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        entities:
          items:
            $ref: '#/components/schemas/TikTokTextEntity'
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type: string
        isLikedByCreator:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        labels:
          items:
            $ref: '#/components/schemas/TikTokCommentLabel'
          type:
          - array
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokCommentMetrics'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        predictions:
          $ref: '#/components/schemas/TikTokCommentPredictions'
        previewReplies:
          items:
            $ref: '#/components/schemas/TikTokCommentReference'
          type:
          - array
          - 'null'
        replyTo:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        rootCommentId:
          minLength: 1
          type:
          - string
          - 'null'
        sticker:
          anyOf:
          - $ref: '#/components/schemas/TikTokCommentSticker'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - postId
      - text
      - createdAt
      - language
      - author
      - isPinned
      - isLikedByCreator
      - parentId
      - rootCommentId
      - replyTo
      - metrics
      - predictions
      - entities
      - labels
      - previewReplies
      - media
      - sticker
      type: object
    TikTokCommentLabel:
      additionalProperties: false
      properties:
        text:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
      required:
      - text
      - typeCode
      type: object
    TikTokCommentMetrics:
      additionalProperties: false
      properties:
        likes:
          type:
          - integer
          - 'null'
        replies:
          type:
          - integer
          - 'null'
      required:
      - likes
      - replies
      type: object
    TikTokCommentPredictions:
      additionalProperties: false
      properties:
        highPurchaseIntent:
          type:
          - boolean
          - 'null'
      required:
      - highPurchaseIntent
      type: object
    TikTokCommentReference:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        entities:
          items:
            $ref: '#/components/schemas/TikTokTextEntity'
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isLikedByCreator:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        labels:
          items:
            $ref: '#/components/schemas/TikTokCommentLabel'
          type:
          - array
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokCommentMetrics'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
        predictions:
          $ref: '#/components/schemas/TikTokCommentPredictions'
        previewReplies:
          items:
            $ref: '#/components/schemas/TikTokCommentReference'
          type:
          - array
          - 'null'
        replyTo:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        rootCommentId:
          minLength: 1
          type:
          - string
          - 'null'
        sticker:
          anyOf:
          - $ref: '#/components/schemas/TikTokCommentSticker'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - postId
      - text
      - createdAt
      - language
      - author
      - isPinned
      - isLikedByCreator
      - parentId
      - rootCommentId
      - replyTo
      - metrics
      - predictions
      - entities
      - labels
      - previewReplies
      - media
      - sticker
      type: object
    TikTokCommentSticker:
      additionalProperties: false
      properties:
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        creatorId:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        renditions:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        setId:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
      required:
      - id
      - creatorId
      - setId
      - name
      - typeCode
      - createdAt
      - renditions
      type: object
    TikTokCommerceMetrics:
      additionalProperties: false
      properties:
        products:
          type:
          - integer
          - 'null'
      required:
      - products
      type: object
    TikTokCoordinates:
      additionalProperties: false
      properties:
        geohash:
          minLength: 1
          type:
          - string
          - 'null'
        latitude:
          type:
          - number
          - 'null'
        longitude:
          type:
          - number
          - 'null'
      required:
      - latitude
      - longitude
      - geohash
      type: object
    TikTokDistrict:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        parentName:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - parentName
      type: object
    TikTokEffect:
      additionalProperties: false
      properties:
        attributions:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        children:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        classification:
          $ref: '#/components/schemas/TikTokEffectClassification'
        creation:
          $ref: '#/components/schemas/TikTokEffectCreation'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        effectId:
          minLength: 1
          type:
          - string
          - 'null'
        icon:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        id:
          minLength: 1
          type: string
        isTopEffect:
          type:
          - boolean
          - 'null'
        linkedAnchors:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokEffectMetrics'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        owner:
          anyOf:
          - $ref: '#/components/schemas/TikTokEffectOwner'
          - type: 'null'
        publishedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        resourceId:
          minLength: 1
          type:
          - string
          - 'null'
        tags:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        triggers:
          items:
            $ref: '#/components/schemas/TikTokEffectTrigger'
          type:
          - array
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - effectId
      - resourceId
      - name
      - description
      - publishedAt
      - url
      - isTopEffect
      - tags
      - owner
      - icon
      - metrics
      - classification
      - creation
      - triggers
      - children
      - attributions
      - linkedAnchors
      type: object
    TikTokEffectClassification:
      additionalProperties: false
      properties:
        creatorTypeCode:
          type:
          - integer
          - 'null'
        sourceCode:
          type:
          - integer
          - 'null'
      required:
      - creatorTypeCode
      - sourceCode
      type: object
    TikTokEffectCreation:
      additionalProperties: false
      properties:
        isEffectHouse:
          type:
          - boolean
          - 'null'
        isExternalProducer:
          type:
          - boolean
          - 'null'
      required:
      - isEffectHouse
      - isExternalProducer
      type: object
    TikTokEffectMetrics:
      additionalProperties: false
      properties:
        uses:
          type:
          - integer
          - 'null'
        views:
          type:
          - integer
          - 'null'
      required:
      - uses
      - views
      type: object
    TikTokEffectOwner:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isTopEffectDesigner:
          type:
          - boolean
          - 'null'
        secUid:
          minLength: 1
          type:
          - string
          - 'null'
        verification:
          $ref: '#/components/schemas/TikTokEffectOwnerVerification'
      required:
      - id
      - secUid
      - displayName
      - avatar
      - isTopEffectDesigner
      - verification
      type: object
    TikTokEffectOwnerVerification:
      additionalProperties: false
      properties:
        typeCode:
          type:
          - integer
          - 'null'
      required:
      - typeCode
      type: object
    TikTokEffectReference:
      additionalProperties: false
      properties:
        attributions:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        children:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        classification:
          $ref: '#/components/schemas/TikTokEffectClassification'
        creation:
          $ref: '#/components/schemas/TikTokEffectCreation'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        effectId:
          minLength: 1
          type:
          - string
          - 'null'
        icon:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isTopEffect:
          type:
          - boolean
          - 'null'
        linkedAnchors:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokEffectMetrics'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        owner:
          anyOf:
          - $ref: '#/components/schemas/TikTokEffectOwner'
          - type: 'null'
        publishedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        resourceId:
          minLength: 1
          type:
          - string
          - 'null'
        tags:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        triggers:
          items:
            $ref: '#/components/schemas/TikTokEffectTrigger'
          type:
          - array
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - effectId
      - resourceId
      - name
      - description
      - publishedAt
      - url
      - isTopEffect
      - tags
      - owner
      - icon
      - metrics
      - classification
      - creation
      - triggers
      - children
      - attributions
      - linkedAnchors
      type: object
    TikTokEffectTrigger:
      additionalProperties: false
      properties:
        actionCodes:
          items:
            type: integer
          type:
          - array
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - type
      - actionCodes
      type: object
    TikTokHashtag:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        classification:
          $ref: '#/components/schemas/TikTokHashtagClassification'
        cover:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        isCommerce:
          type:
          - boolean
          - 'null'
        isStrongMusic:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokHashtagMetrics'
        music:
          items:
            $ref: '#/components/schemas/TikTokMusicReference'
          type:
          - array
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        searchContext:
          $ref: '#/components/schemas/TikTokHashtagSearchContext'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - name
      - url
      - description
      - isCommerce
      - isStrongMusic
      - classification
      - metrics
      - avatar
      - cover
      - music
      - searchContext
      type: object
    TikTokHashtagClassification:
      additionalProperties: false
      properties:
        challengeCode:
          type:
          - integer
          - 'null'
        subtypeCode:
          type:
          - integer
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
      required:
      - typeCode
      - subtypeCode
      - challengeCode
      type: object
    TikTokHashtagMetrics:
      additionalProperties: false
      properties:
        users:
          type:
          - integer
          - 'null'
        uses:
          type:
          - integer
          - 'null'
        views:
          type:
          - integer
          - 'null'
      required:
      - uses
      - users
      - views
      type: object
    TikTokHashtagReference:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - url
      type: object
    TikTokHashtagSearchContext:
      additionalProperties: false
      properties:
        name:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - name
      type: object
    TikTokInteractionSticker:
      additionalProperties: false
      properties:
        hashtag:
          anyOf:
          - $ref: '#/components/schemas/TikTokHashtagReference'
          - type: 'null'
        index:
          type:
          - integer
          - 'null'
        isTextHashtag:
          type:
          - boolean
          - 'null'
        materialIndex:
          type:
          - integer
          - 'null'
        positions:
          items:
            $ref: '#/components/schemas/TikTokStickerPosition'
          type:
          - array
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
      required:
      - typeCode
      - index
      - materialIndex
      - text
      - hashtag
      - isTextHashtag
      - positions
      type: object
    TikTokLocation:
      additionalProperties: false
      properties:
        address:
          $ref: '#/components/schemas/TikTokLocationAddress'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        classification:
          $ref: '#/components/schemas/TikTokLocationClassification'
        commerce:
          $ref: '#/components/schemas/TikTokLocationCommerce'
        coordinates:
          $ref: '#/components/schemas/TikTokCoordinates'
        externalUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        metrics:
          $ref: '#/components/schemas/TikTokLocationMetrics'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        openingHours:
          $ref: '#/components/schemas/TikTokOpeningHours'
        parent:
          anyOf:
          - $ref: '#/components/schemas/TikTokLocationParent'
          - type: 'null'
        priceLevel:
          minLength: 1
          type:
          - string
          - 'null'
        rating:
          $ref: '#/components/schemas/TikTokLocationRating'
        source:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - category
      - source
      - url
      - address
      - coordinates
      - parent
      - classification
      - metrics
      - rating
      - priceLevel
      - externalUrl
      - openingHours
      - commerce
      type: object
    TikTokLocationAddress:
      additionalProperties: false
      properties:
        city:
          minLength: 1
          type:
          - string
          - 'null'
        cityCode:
          minLength: 1
          type:
          - string
          - 'null'
        countryCode:
          minLength: 1
          type:
          - string
          - 'null'
        district:
          anyOf:
          - $ref: '#/components/schemas/TikTokDistrict'
          - type: 'null'
        fallback:
          minLength: 1
          type:
          - string
          - 'null'
        formatted:
          minLength: 1
          type:
          - string
          - 'null'
        regionCode:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - formatted
      - fallback
      - city
      - cityCode
      - regionCode
      - countryCode
      - district
      type: object
    TikTokLocationClassification:
      additionalProperties: false
      properties:
        backendType:
          minLength: 1
          type:
          - string
          - 'null'
        className:
          minLength: 1
          type:
          - string
          - 'null'
        code:
          minLength: 1
          type:
          - string
          - 'null'
        detailType:
          minLength: 1
          type:
          - string
          - 'null'
        hierarchy:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        levelCode:
          minLength: 1
          type:
          - string
          - 'null'
        serviceCategory:
          $ref: '#/components/schemas/TikTokServiceCategory'
        sourceCode:
          type:
          - integer
          - 'null'
      required:
      - code
      - className
      - detailType
      - sourceCode
      - levelCode
      - backendType
      - hierarchy
      - serviceCategory
      type: object
    TikTokLocationCommerce:
      additionalProperties: false
      properties:
        hasProductShelf:
          type:
          - boolean
          - 'null'
        isClaimed:
          type:
          - boolean
          - 'null'
      required:
      - hasProductShelf
      - isClaimed
      type: object
    TikTokLocationMetrics:
      additionalProperties: false
      properties:
        favorites:
          type:
          - integer
          - 'null'
        reviews:
          type:
          - integer
          - 'null'
        videos:
          type:
          - integer
          - 'null'
      required:
      - favorites
      - reviews
      - videos
      type: object
    TikTokLocationParent:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      type: object
    TikTokLocationRating:
      additionalProperties: false
      properties:
        hasRating:
          type:
          - boolean
          - 'null'
        maxScore:
          type:
          - number
          - 'null'
        score:
          type:
          - number
          - 'null'
        source:
          $ref: '#/components/schemas/TikTokRatingSource'
      required:
      - score
      - maxScore
      - hasRating
      - source
      type: object
    TikTokLocationReference:
      additionalProperties: false
      properties:
        address:
          $ref: '#/components/schemas/TikTokLocationAddress'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        classification:
          $ref: '#/components/schemas/TikTokLocationClassification'
        commerce:
          $ref: '#/components/schemas/TikTokLocationCommerce'
        coordinates:
          $ref: '#/components/schemas/TikTokCoordinates'
        externalUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokLocationMetrics'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        openingHours:
          $ref: '#/components/schemas/TikTokOpeningHours'
        parent:
          anyOf:
          - $ref: '#/components/schemas/TikTokLocationParent'
          - type: 'null'
        priceLevel:
          minLength: 1
          type:
          - string
          - 'null'
        rating:
          $ref: '#/components/schemas/TikTokLocationRating'
        source:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - category
      - source
      - url
      - address
      - coordinates
      - parent
      - classification
      - metrics
      - rating
      - priceLevel
      - externalUrl
      - openingHours
      - commerce
      type: object
    TikTokLyricAsset:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - typeCode
      - url
      type: object
    TikTokMatchedTrack:
      additionalProperties: false
      properties:
        artistName:
          minLength: 1
          type:
          - string
          - 'null'
        artists:
          items:
            $ref: '#/components/schemas/TikTokProfileReference'
          type:
          - array
          - 'null'
        chorus:
          $ref: '#/components/schemas/TikTokMusicPreview'
        cover:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        duration:
          type:
          - number
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        mixedArtistName:
          minLength: 1
          type:
          - string
          - 'null'
        mixedTitle:
          minLength: 1
          type:
          - string
          - 'null'
        release:
          $ref: '#/components/schemas/TikTokMusicRelease'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - title
      - artistName
      - mixedTitle
      - mixedArtistName
      - cover
      - duration
      - chorus
      - url
      - artists
      - release
      type: object
    TikTokMusic:
      additionalProperties: false
      properties:
        album:
          minLength: 1
          type:
          - string
          - 'null'
        appleMusicSongId:
          minLength: 1
          type:
          - string
          - 'null'
        artistName:
          minLength: 1
          type:
          - string
          - 'null'
        artists:
          items:
            $ref: '#/components/schemas/TikTokProfileReference'
          type:
          - array
          - 'null'
        audio:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        beatData:
          anyOf:
          - $ref: '#/components/schemas/TikTokBeatData'
          - type: 'null'
        chartContext:
          $ref: '#/components/schemas/TikTokMusicChartContext'
        classification:
          $ref: '#/components/schemas/TikTokMusicClassification'
        covers:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        duration:
          type:
          - number
          - 'null'
        durations:
          $ref: '#/components/schemas/TikTokMusicDurations'
        externalSongs:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        grouping:
          $ref: '#/components/schemas/TikTokMusicGrouping'
        hasBehindTheSong:
          type:
          - boolean
          - 'null'
        hasHumanVoice:
          type:
          - boolean
          - 'null'
        hasMatchedMetadata:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type: string
        isAuthorArtist:
          type:
          - boolean
          - 'null'
        isAuthorDeleted:
          type:
          - boolean
          - 'null'
        isOriginal:
          type:
          - boolean
          - 'null'
        isOriginalSound:
          type:
          - boolean
          - 'null'
        isPgc:
          type:
          - boolean
          - 'null'
        isPlayMusic:
          type:
          - boolean
          - 'null'
        lyricAssets:
          items:
            $ref: '#/components/schemas/TikTokLyricAsset'
          type:
          - array
          - 'null'
        matchedCatalogTrack:
          anyOf:
          - $ref: '#/components/schemas/TikTokMusicReference'
          - type: 'null'
        matchedSong:
          anyOf:
          - $ref: '#/components/schemas/TikTokMatchedTrack'
          - type: 'null'
        matchedSound:
          anyOf:
          - $ref: '#/components/schemas/TikTokMatchedTrack'
          - type: 'null'
        metrics:
          $ref: '#/components/schemas/TikTokMusicMetrics'
        mid:
          minLength: 1
          type:
          - string
          - 'null'
        owner:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        preview:
          $ref: '#/components/schemas/TikTokMusicPreview'
        recommendationStatusCode:
          type:
          - integer
          - 'null'
        release:
          $ref: '#/components/schemas/TikTokMusicRelease'
        searchContext:
          $ref: '#/components/schemas/TikTokMusicSearchContext'
        similarTracks:
          items:
            $ref: '#/components/schemas/TikTokMusicReference'
          type:
          - array
          - 'null'
        source:
          $ref: '#/components/schemas/TikTokMusicSource'
        streamingLinks:
          items:
            $ref: '#/components/schemas/TikTokStreamingLink'
          type:
          - array
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - mid
      - title
      - artistName
      - album
      - url
      - duration
      - createdAt
      - isOriginal
      - isOriginalSound
      - isAuthorArtist
      - hasHumanVoice
      - isAuthorDeleted
      - isPgc
      - hasMatchedMetadata
      - recommendationStatusCode
      - isPlayMusic
      - owner
      - artists
      - metrics
      - audio
      - covers
      - beatData
      - durations
      - release
      - preview
      - matchedSong
      - matchedSound
      - classification
      - grouping
      - streamingLinks
      - lyricAssets
      - source
      - appleMusicSongId
      - searchContext
      - chartContext
      - matchedCatalogTrack
      - hasBehindTheSong
      - similarTracks
      - externalSongs
      type: object
    TikTokMusicChartContext:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        position:
          type:
          - integer
          - 'null'
        trendCode:
          type:
          - integer
          - 'null'
      required:
      - id
      - position
      - trendCode
      type: object
    TikTokMusicClassification:
      additionalProperties: false
      properties:
        languageLabel:
          minLength: 1
          type:
          - string
          - 'null'
        styleCodes:
          items:
            type: integer
          type:
          - array
          - 'null'
        themeCodes:
          items:
            type: integer
          type:
          - array
          - 'null'
        themes:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
      required:
      - themes
      - themeCodes
      - styleCodes
      - languageLabel
      type: object
    TikTokMusicContext:
      additionalProperties: false
      properties:
        label:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - label
      type: object
    TikTokMusicDurations:
      additionalProperties: false
      properties:
        shoot:
          type:
          - number
          - 'null'
        video:
          type:
          - number
          - 'null'
      required:
      - shoot
      - video
      type: object
    TikTokMusicGrouping:
      additionalProperties: false
      properties:
        groupIds:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        sameGroupId:
          minLength: 1
          type:
          - string
          - 'null'
        similarGroupId:
          minLength: 1
          type:
          - string
          - 'null'
        ugid:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - sameGroupId
      - similarGroupId
      - ugid
      - groupIds
      type: object
    TikTokMusicMetrics:
      additionalProperties: false
      properties:
        groupUses:
          type:
          - integer
          - 'null'
        posts:
          type:
          - integer
          - 'null'
        ugidUses:
          type:
          - integer
          - 'null'
      required:
      - posts
      - groupUses
      - ugidUses
      type: object
    TikTokMusicPreview:
      additionalProperties: false
      properties:
        duration:
          type:
          - number
          - 'null'
        endTime:
          type:
          - number
          - 'null'
        startTime:
          type:
          - number
          - 'null'
      required:
      - startTime
      - endTime
      - duration
      type: object
    TikTokMusicReference:
      additionalProperties: false
      properties:
        album:
          minLength: 1
          type:
          - string
          - 'null'
        appleMusicSongId:
          minLength: 1
          type:
          - string
          - 'null'
        artistName:
          minLength: 1
          type:
          - string
          - 'null'
        artists:
          items:
            $ref: '#/components/schemas/TikTokProfileReference'
          type:
          - array
          - 'null'
        audio:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        beatData:
          anyOf:
          - $ref: '#/components/schemas/TikTokBeatData'
          - type: 'null'
        chartContext:
          $ref: '#/components/schemas/TikTokMusicChartContext'
        classification:
          $ref: '#/components/schemas/TikTokMusicClassification'
        covers:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        duration:
          type:
          - number
          - 'null'
        durations:
          $ref: '#/components/schemas/TikTokMusicDurations'
        externalSongs:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        grouping:
          $ref: '#/components/schemas/TikTokMusicGrouping'
        hasBehindTheSong:
          type:
          - boolean
          - 'null'
        hasHumanVoice:
          type:
          - boolean
          - 'null'
        hasMatchedMetadata:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAuthorArtist:
          type:
          - boolean
          - 'null'
        isAuthorDeleted:
          type:
          - boolean
          - 'null'
        isOriginal:
          type:
          - boolean
          - 'null'
        isOriginalSound:
          type:
          - boolean
          - 'null'
        isPgc:
          type:
          - boolean
          - 'null'
        isPlayMusic:
          type:
          - boolean
          - 'null'
        lyricAssets:
          items:
            $ref: '#/components/schemas/TikTokLyricAsset'
          type:
          - array
          - 'null'
        matchedCatalogTrack:
          anyOf:
          - $ref: '#/components/schemas/TikTokMusicReference'
          - type: 'null'
        matchedSong:
          anyOf:
          - $ref: '#/components/schemas/TikTokMatchedTrack'
          - type: 'null'
        matchedSound:
          anyOf:
          - $ref: '#/components/schemas/TikTokMatchedTrack'
          - type: 'null'
        metrics:
          $ref: '#/components/schemas/TikTokMusicMetrics'
        mid:
          minLength: 1
          type:
          - string
          - 'null'
        owner:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        preview:
          $ref: '#/components/schemas/TikTokMusicPreview'
        recommendationStatusCode:
          type:
          - integer
          - 'null'
        release:
          $ref: '#/components/schemas/TikTokMusicRelease'
        searchContext:
          $ref: '#/components/schemas/TikTokMusicSearchContext'
        similarTracks:
          items:
            $ref: '#/components/schemas/TikTokMusicReference'
          type:
          - array
          - 'null'
        source:
          $ref: '#/components/schemas/TikTokMusicSource'
        streamingLinks:
          items:
            $ref: '#/components/schemas/TikTokStreamingLink'
          type:
          - array
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - mid
      - title
      - artistName
      - album
      - url
      - duration
      - createdAt
      - isOriginal
      - isOriginalSound
      - isAuthorArtist
      - hasHumanVoice
      - isAuthorDeleted
      - isPgc
      - hasMatchedMetadata
      - recommendationStatusCode
      - isPlayMusic
      - owner
      - artists
      - metrics
      - audio
      - covers
      - beatData
      - durations
      - release
      - preview
      - matchedSong
      - matchedSound
      - classification
      - grouping
      - streamingLinks
      - lyricAssets
      - source
      - appleMusicSongId
      - searchContext
      - chartContext
      - matchedCatalogTrack
      - hasBehindTheSong
      - similarTracks
      - externalSongs
      type: object
    TikTokMusicRelease:
      additionalProperties: false
      properties:
        date:
          minLength: 1
          type:
          - string
          - 'null'
        isNewRelease:
          type:
          - boolean
          - 'null'
      required:
      - isNewRelease
      - date
      type: object
    TikTokMusicSearchContext:
      additionalProperties: false
      properties:
        description:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        relatedQuery:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - name
      - description
      - relatedQuery
      type: object
    TikTokMusicSource:
      additionalProperties: false
      properties:
        audioAssetId:
          minLength: 1
          type:
          - string
          - 'null'
        sourcePostId:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - sourcePostId
      - audioAssetId
      type: object
    TikTokOpeningHours:
      additionalProperties: false
      properties:
        endTime:
          minLength: 1
          type:
          - string
          - 'null'
        entries:
          items:
            $ref: '#/components/schemas/TikTokOpeningHoursEntry'
          type:
          - array
          - 'null'
        startTime:
          minLength: 1
          type:
          - string
          - 'null'
        status:
          type:
          - boolean
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - entries
      - text
      - startTime
      - endTime
      - status
      type: object
    TikTokOpeningHoursEntry:
      additionalProperties: false
      properties:
        dayCode:
          type:
          - integer
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - dayCode
      - text
      type: object
    TikTokPageContinuation:
      additionalProperties: false
      properties:
        maxTime:
          type:
          - integer
          - 'null'
        minTime:
          type:
          - integer
          - 'null'
        offset:
          type:
          - integer
          - 'null'
        pageToken:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - pageToken
      - minTime
      - maxTime
      - offset
      type: object
    TikTokPageMetadata:
      additionalProperties: false
      properties:
        chart:
          anyOf:
          - $ref: '#/components/schemas/TikTokChartMetadata'
          - type: 'null'
        continuation:
          anyOf:
          - $ref: '#/components/schemas/TikTokPageContinuation'
          - type: 'null'
        hasFilteredComments:
          type:
          - boolean
          - 'null'
        hasMore:
          type:
          - boolean
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            comments:
              type:
              - integer
              - 'null'
            followers:
              type:
              - integer
              - 'null'
            following:
              type:
              - integer
              - 'null'
            results:
              type:
              - integer
              - 'null'
          required:
          - comments
          - followers
          - following
          - results
          type: object
        query:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - hasMore
      - metrics
      - hasFilteredComments
      - query
      - chart
      - continuation
      type: object
    TikTokPlaylist:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        creatorName:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        index:
          type:
          - integer
          - 'null'
        lastPostAddedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokPlaylistMetrics'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - url
      - creatorName
      - author
      - typeCode
      - index
      - lastPostAddedAt
      - metrics
      type: object
    TikTokPlaylistMetrics:
      additionalProperties: false
      properties:
        plays:
          type:
          - integer
          - 'null'
        posts:
          type:
          - integer
          - 'null'
      required:
      - posts
      - plays
      type: object
    TikTokPlaylistReference:
      additionalProperties: false
      properties:
        author:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        creatorName:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        index:
          type:
          - integer
          - 'null'
        lastPostAddedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokPlaylistMetrics'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - url
      - creatorName
      - author
      - typeCode
      - index
      - lastPostAddedAt
      - metrics
      type: object
    TikTokPost:
      additionalProperties: false
      properties:
        ai:
          $ref: '#/components/schemas/TikTokPostAI'
        audio:
          $ref: '#/components/schemas/TikTokPostAudio'
        author:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        authorId:
          minLength: 1
          type:
          - string
          - 'null'
        caption:
          $ref: '#/components/schemas/TikTokPostCaption'
        collaborators:
          items:
            $ref: '#/components/schemas/TikTokCollaborator'
          type:
          - array
          - 'null'
        commerce:
          $ref: '#/components/schemas/TikTokPostCommerce'
        cover:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        description:
          minLength: 1
          type:
          - string
          - 'null'
        effects:
          items:
            $ref: '#/components/schemas/TikTokEffectReference'
          type:
          - array
          - 'null'
        entities:
          items:
            $ref: '#/components/schemas/TikTokTextEntity'
          type:
          - array
          - 'null'
        hasDanmaku:
          type:
          - boolean
          - 'null'
        hasPromotionalMusic:
          type:
          - boolean
          - 'null'
        hashtags:
          items:
            $ref: '#/components/schemas/TikTokHashtagReference'
          type: array
        id:
          minLength: 1
          type: string
        isAd:
          type:
          - boolean
          - 'null'
        isMeme:
          type:
          - boolean
          - 'null'
        isPaidContent:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        isVr:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        locations:
          items:
            $ref: '#/components/schemas/TikTokLocationReference'
          type:
          - array
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type: array
        metrics:
          $ref: '#/components/schemas/TikTokPostMetrics'
        musicContext:
          $ref: '#/components/schemas/TikTokMusicContext'
        onScreenText:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        paidCollectionId:
          minLength: 1
          type:
          - string
          - 'null'
        playlist:
          anyOf:
          - $ref: '#/components/schemas/TikTokPlaylistReference'
          - type: 'null'
        region:
          minLength: 1
          type:
          - string
          - 'null'
        searchContext:
          $ref: '#/components/schemas/TikTokPostSearchContext'
        status:
          $ref: '#/components/schemas/TikTokPostStatus'
        stickers:
          items:
            $ref: '#/components/schemas/TikTokInteractionSticker'
          type:
          - array
          - 'null'
        template:
          anyOf:
          - $ref: '#/components/schemas/TikTokPostTemplate'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - type
      - url
      - text
      - title
      - description
      - region
      - language
      - createdAt
      - author
      - authorId
      - isAd
      - isPaidContent
      - isVr
      - hasPromotionalMusic
      - hasDanmaku
      - isPinned
      - isMeme
      - media
      - cover
      - metrics
      - status
      - ai
      - commerce
      - entities
      - hashtags
      - locations
      - caption
      - searchContext
      - collaborators
      - audio
      - template
      - paidCollectionId
      - onScreenText
      - playlist
      - effects
      - stickers
      - musicContext
      type: object
    TikTokPostAI:
      additionalProperties: false
      properties:
        isCreatedByAi:
          type:
          - boolean
          - 'null'
        labelType:
          type:
          - integer
          - 'null'
      required:
      - isCreatedByAi
      - labelType
      type: object
    TikTokPostAudio:
      additionalProperties: false
      properties:
        addedTrack:
          anyOf:
          - $ref: '#/components/schemas/TikTokMusicReference'
          - type: 'null'
        addedVolume:
          type:
          - number
          - 'null'
        endTime:
          type:
          - number
          - 'null'
        originalVolume:
          type:
          - number
          - 'null'
        startTime:
          type:
          - number
          - 'null'
        track:
          anyOf:
          - $ref: '#/components/schemas/TikTokMusicReference'
          - type: 'null'
        usesFullSong:
          type:
          - boolean
          - 'null'
      required:
      - track
      - addedTrack
      - startTime
      - endTime
      - originalVolume
      - addedVolume
      - usesFullSong
      type: object
    TikTokPostCaption:
      additionalProperties: false
      properties:
        entities:
          items:
            $ref: '#/components/schemas/TikTokTextEntity'
          type:
          - array
          - 'null'
        markup:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - markup
      - entities
      type: object
    TikTokPostCommerce:
      additionalProperties: false
      properties:
        brandedContentType:
          type:
          - integer
          - 'null'
        disclosureLabel:
          minLength: 1
          type:
          - string
          - 'null'
        isDiversionAd:
          type:
          - boolean
          - 'null'
        isEcommerce:
          type:
          - boolean
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokCommerceMetrics'
        products:
          items:
            $ref: '#/components/schemas/TikTokProduct'
          type:
          - array
          - 'null'
        sellerIds:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
      required:
      - brandedContentType
      - isDiversionAd
      - disclosureLabel
      - metrics
      - isEcommerce
      - sellerIds
      - products
      type: object
    TikTokPostMetrics:
      additionalProperties: false
      properties:
        comments:
          type:
          - integer
          - 'null'
        downloads:
          type:
          - integer
          - 'null'
        likes:
          type:
          - integer
          - 'null'
        reposts:
          type:
          - integer
          - 'null'
        saves:
          type:
          - integer
          - 'null'
        shares:
          type:
          - integer
          - 'null'
        views:
          type:
          - integer
          - 'null'
        whatsapp:
          $ref: '#/components/schemas/TikTokWhatsAppMetrics'
      required:
      - likes
      - comments
      - views
      - saves
      - shares
      - downloads
      - reposts
      - whatsapp
      type: object
    TikTokPostReference:
      additionalProperties: false
      properties:
        ai:
          $ref: '#/components/schemas/TikTokPostAI'
        audio:
          $ref: '#/components/schemas/TikTokPostAudio'
        author:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
        authorId:
          minLength: 1
          type:
          - string
          - 'null'
        caption:
          $ref: '#/components/schemas/TikTokPostCaption'
        collaborators:
          items:
            $ref: '#/components/schemas/TikTokCollaborator'
          type:
          - array
          - 'null'
        commerce:
          $ref: '#/components/schemas/TikTokPostCommerce'
        cover:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        effects:
          items:
            $ref: '#/components/schemas/TikTokEffectReference'
          type:
          - array
          - 'null'
        entities:
          items:
            $ref: '#/components/schemas/TikTokTextEntity'
          type:
          - array
          - 'null'
        hasDanmaku:
          type:
          - boolean
          - 'null'
        hasPromotionalMusic:
          type:
          - boolean
          - 'null'
        hashtags:
          items:
            $ref: '#/components/schemas/TikTokHashtagReference'
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAd:
          type:
          - boolean
          - 'null'
        isMeme:
          type:
          - boolean
          - 'null'
        isPaidContent:
          type:
          - boolean
          - 'null'
        isPinned:
          type:
          - boolean
          - 'null'
        isVr:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        locations:
          items:
            $ref: '#/components/schemas/TikTokLocationReference'
          type:
          - array
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokPostMetrics'
        musicContext:
          $ref: '#/components/schemas/TikTokMusicContext'
        onScreenText:
          items:
            $ref: '#/components/schemas/TikTokUnspecified'
          type:
          - array
          - 'null'
        paidCollectionId:
          minLength: 1
          type:
          - string
          - 'null'
        playlist:
          anyOf:
          - $ref: '#/components/schemas/TikTokPlaylistReference'
          - type: 'null'
        region:
          minLength: 1
          type:
          - string
          - 'null'
        searchContext:
          $ref: '#/components/schemas/TikTokPostSearchContext'
        status:
          $ref: '#/components/schemas/TikTokPostStatus'
        stickers:
          items:
            $ref: '#/components/schemas/TikTokInteractionSticker'
          type:
          - array
          - 'null'
        template:
          anyOf:
          - $ref: '#/components/schemas/TikTokPostTemplate'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - type
      - url
      - text
      - title
      - description
      - region
      - language
      - createdAt
      - author
      - authorId
      - isAd
      - isPaidContent
      - isVr
      - hasPromotionalMusic
      - hasDanmaku
      - isPinned
      - isMeme
      - media
      - cover
      - metrics
      - status
      - ai
      - commerce
      - entities
      - hashtags
      - locations
      - caption
      - searchContext
      - collaborators
      - audio
      - template
      - paidCollectionId
      - onScreenText
      - playlist
      - effects
      - stickers
      - musicContext
      type: object
    TikTokPostSearchContext:
      additionalProperties: false
      properties:
        description:
          minLength: 1
          type:
          - string
          - 'null'
        highlights:
          items:
            $ref: '#/components/schemas/TikTokSearchHighlight'
          type:
          - array
          - 'null'
      required:
      - description
      - highlights
      type: object
    TikTokPostStatus:
      additionalProperties: false
      properties:
        isDeleted:
          type:
          - boolean
          - 'null'
        isProhibited:
          type:
          - boolean
          - 'null'
        isUnderReview:
          type:
          - boolean
          - 'null'
        privacyCode:
          type:
          - integer
          - 'null'
        reviewedCode:
          type:
          - integer
          - 'null'
      required:
      - isDeleted
      - isProhibited
      - privacyCode
      - isUnderReview
      - reviewedCode
      type: object
    TikTokPostTemplate:
      additionalProperties: false
      properties:
        authorName:
          minLength: 1
          type:
          - string
          - 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        duration:
          type:
          - number
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokTemplateMetrics'
        musicId:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - authorName
      - description
      - duration
      - musicId
      - metrics
      type: object
    TikTokPreviewThumbnails:
      additionalProperties: false
      properties:
        columns:
          type:
          - integer
          - 'null'
        duration:
          type:
          - number
          - 'null'
        format:
          minLength: 1
          type:
          - string
          - 'null'
        imageCount:
          type:
          - integer
          - 'null'
        imageIds:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        images:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        interval:
          type:
          - number
          - 'null'
        rows:
          type:
          - integer
          - 'null'
        tileHeight:
          type:
          - integer
          - 'null'
        tileWidth:
          type:
          - integer
          - 'null'
      required:
      - duration
      - interval
      - imageCount
      - columns
      - rows
      - tileWidth
      - tileHeight
      - format
      - images
      - imageIds
      type: object
    TikTokProduct:
      additionalProperties: false
      properties:
        categories:
          items:
            $ref: '#/components/schemas/TikTokProductCategory'
          type:
          - array
          - 'null'
        cover:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        disclosureLabel:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        images:
          items:
            $ref: '#/components/schemas/TikTokAsset'
          type:
          - array
          - 'null'
        inShop:
          type:
          - boolean
          - 'null'
        isPlatformProduct:
          type:
          - boolean
          - 'null'
        label:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        platformCode:
          type:
          - integer
          - 'null'
        pricing:
          $ref: '#/components/schemas/TikTokProductPricing'
        sellerId:
          minLength: 1
          type:
          - string
          - 'null'
        shortName:
          minLength: 1
          type:
          - string
          - 'null'
        skus:
          items:
            $ref: '#/components/schemas/TikTokProductSKU'
          type:
          - array
          - 'null'
        source:
          minLength: 1
          type:
          - string
          - 'null'
        statusCode:
          type:
          - integer
          - 'null'
      required:
      - id
      - name
      - shortName
      - source
      - platformCode
      - statusCode
      - inShop
      - isPlatformProduct
      - sellerId
      - pricing
      - images
      - cover
      - skus
      - categories
      - disclosureLabel
      - label
      type: object
    TikTokProductCategory:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isLeaf:
          type:
          - boolean
          - 'null'
        level:
          type:
          - integer
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        parentId:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - level
      - isLeaf
      - parentId
      type: object
    TikTokProductPricing:
      additionalProperties: false
      properties:
        currency:
          minLength: 1
          type:
          - string
          - 'null'
        marketPrice:
          type:
          - integer
          - 'null'
        price:
          type:
          - integer
          - 'null'
      required:
      - price
      - marketPrice
      - currency
      type: object
    TikTokProductSKU:
      additionalProperties: false
      properties:
        externalId:
          minLength: 1
          type:
          - string
          - 'null'
        externalProductId:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - externalId
      - externalProductId
      type: object
    TikTokProfile:
      additionalProperties: false
      properties:
        accountType:
          type:
          - integer
          - 'null'
        avatar:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        commerce:
          additionalProperties: false
          properties:
            hasLiveCommerce:
              type:
              - boolean
              - 'null'
            hasNewProducts:
              type:
              - boolean
              - 'null'
            level:
              type:
              - integer
              - 'null'
          required:
          - level
          - hasLiveCommerce
          - hasNewProducts
          type: object
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type: string
        id:
          minLength: 1
          type: string
        isAdVirtual:
          type:
          - boolean
          - 'null'
        isCanceled:
          type:
          - boolean
          - 'null'
        isDisciplineMember:
          type:
          - boolean
          - 'null'
        isEffectArtist:
          type:
          - boolean
          - 'null'
        isPrivate:
          type:
          - boolean
          - 'null'
        isStar:
          type:
          - boolean
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokProfileMetrics'
        music:
          additionalProperties: false
          properties:
            metrics:
              additionalProperties: false
              properties:
                likes:
                  type:
                  - integer
                  - 'null'
                tracks:
                  type:
                  - integer
                  - 'null'
                uses:
                  type:
                  - integer
                  - 'null'
              required:
              - tracks
              - uses
              - likes
              type: object
            newReleaseIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
          required:
          - metrics
          - newReleaseIds
          type: object
        predictions:
          additionalProperties: false
          properties:
            ageGroup:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - ageGroup
          type: object
        privacy:
          additionalProperties: false
          properties:
            followingVisibility:
              type:
              - integer
              - 'null'
          required:
          - followingVisibility
          type: object
        regionCode:
          minLength: 1
          type:
          - string
          - 'null'
        searchContext:
          additionalProperties: false
          properties:
            description:
              minLength: 1
              type:
              - string
              - 'null'
            name:
              minLength: 1
              type:
              - string
              - 'null'
            nameField:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - description
          - name
          - nameField
          type: object
        secUid:
          minLength: 1
          type:
          - string
          - 'null'
        socialLinks:
          items:
            $ref: '#/components/schemas/TikTokSocialLink'
          type:
          - array
          - 'null'
        stories:
          additionalProperties: false
          properties:
            changedAt:
              format: date-time
              minLength: 1
              type:
              - string
              - 'null'
            items:
              items:
                $ref: '#/components/schemas/TikTokStoryReference'
              type:
              - array
              - 'null'
            metrics:
              additionalProperties: false
              properties:
                countsByPostType:
                  items:
                    $ref: '#/components/schemas/TikTokStoryCount'
                  type:
                  - array
                  - 'null'
              required:
              - countsByPostType
              type: object
          required:
          - items
          - changedAt
          - metrics
          type: object
        storyStatus:
          type:
          - integer
          - 'null'
        url:
          format: uri
          minLength: 1
          type: string
        verification:
          additionalProperties: false
          properties:
            badgeType:
              type:
              - integer
              - 'null'
            customLabel:
              minLength: 1
              type:
              - string
              - 'null'
            label:
              minLength: 1
              type:
              - string
              - 'null'
            type:
              type:
              - integer
              - 'null'
          required:
          - type
          - badgeType
          - label
          - customLabel
          type: object
      required:
      - id
      - secUid
      - handle
      - displayName
      - bio
      - url
      - createdAt
      - avatar
      - isPrivate
      - isVerified
      - accountType
      - isEffectArtist
      - isAdVirtual
      - isStar
      - storyStatus
      - isDisciplineMember
      - isCanceled
      - regionCode
      - language
      - category
      - verification
      - metrics
      - commerce
      - privacy
      - music
      - predictions
      - searchContext
      - socialLinks
      - stories
      type: object
    TikTokProfileMetrics:
      additionalProperties: false
      properties:
        followers:
          type:
          - integer
          - 'null'
        following:
          type:
          - integer
          - 'null'
        likedPosts:
          type:
          - integer
          - 'null'
        likes:
          type:
          - integer
          - 'null'
        posts:
          type:
          - integer
          - 'null'
        visiblePosts:
          type:
          - integer
          - 'null'
      required:
      - followers
      - following
      - posts
      - visiblePosts
      - likes
      - likedPosts
      type: object
    TikTokProfileReference:
      additionalProperties: false
      properties:
        accountType:
          type:
          - integer
          - 'null'
        avatar:
          anyOf:
          - $ref: '#/components/schemas/TikTokAsset'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        category:
          minLength: 1
          type:
          - string
          - 'null'
        commerce:
          additionalProperties: false
          properties:
            hasLiveCommerce:
              type:
              - boolean
              - 'null'
            hasNewProducts:
              type:
              - boolean
              - 'null'
            level:
              type:
              - integer
              - 'null'
          required:
          - level
          - hasLiveCommerce
          - hasNewProducts
          type: object
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAdVirtual:
          type:
          - boolean
          - 'null'
        isCanceled:
          type:
          - boolean
          - 'null'
        isDisciplineMember:
          type:
          - boolean
          - 'null'
        isEffectArtist:
          type:
          - boolean
          - 'null'
        isPrivate:
          type:
          - boolean
          - 'null'
        isStar:
          type:
          - boolean
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          $ref: '#/components/schemas/TikTokProfileMetrics'
        music:
          additionalProperties: false
          properties:
            metrics:
              additionalProperties: false
              properties:
                likes:
                  type:
                  - integer
                  - 'null'
                tracks:
                  type:
                  - integer
                  - 'null'
                uses:
                  type:
                  - integer
                  - 'null'
              required:
              - tracks
              - uses
              - likes
              type: object
            newReleaseIds:
              items:
                minLength: 1
                type: string
              type:
              - array
              - 'null'
          required:
          - metrics
          - newReleaseIds
          type: object
        predictions:
          additionalProperties: false
          properties:
            ageGroup:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - ageGroup
          type: object
        privacy:
          additionalProperties: false
          properties:
            followingVisibility:
              type:
              - integer
              - 'null'
          required:
          - followingVisibility
          type: object
        regionCode:
          minLength: 1
          type:
          - string
          - 'null'
        searchContext:
          additionalProperties: false
          properties:
            description:
              minLength: 1
              type:
              - string
              - 'null'
            name:
              minLength: 1
              type:
              - string
              - 'null'
            nameField:
              minLength: 1
              type:
              - string
              - 'null'
          required:
          - description
          - name
          - nameField
          type: object
        secUid:
          minLength: 1
          type:
          - string
          - 'null'
        socialLinks:
          items:
            $ref: '#/components/schemas/TikTokSocialLink'
          type:
          - array
          - 'null'
        stories:
          additionalProperties: false
          properties:
            changedAt:
              format: date-time
              minLength: 1
              type:
              - string
              - 'null'
            items:
              items:
                $ref: '#/components/schemas/TikTokStoryReference'
              type:
              - array
              - 'null'
            metrics:
              additionalProperties: false
              properties:
                countsByPostType:
                  items:
                    $ref: '#/components/schemas/TikTokStoryCount'
                  type:
                  - array
                  - 'null'
              required:
              - countsByPostType
              type: object
          required:
          - items
          - changedAt
          - metrics
          type: object
        storyStatus:
          type:
          - integer
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        verification:
          additionalProperties: false
          properties:
            badgeType:
              type:
              - integer
              - 'null'
            customLabel:
              minLength: 1
              type:
              - string
              - 'null'
            label:
              minLength: 1
              type:
              - string
              - 'null'
            type:
              type:
              - integer
              - 'null'
          required:
          - type
          - badgeType
          - label
          - customLabel
          type: object
      required:
      - id
      - secUid
      - handle
      - displayName
      - bio
      - url
      - createdAt
      - avatar
      - isPrivate
      - isVerified
      - accountType
      - isEffectArtist
      - isAdVirtual
      - isStar
      - storyStatus
      - isDisciplineMember
      - isCanceled
      - regionCode
      - language
      - category
      - verification
      - metrics
      - commerce
      - privacy
      - music
      - predictions
      - searchContext
      - socialLinks
      - stories
      type: object
    TikTokRatingSource:
      additionalProperties: false
      properties:
        code:
          type:
          - integer
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - code
      - name
      type: object
    TikTokSearchHighlight:
      additionalProperties: false
      properties:
        field:
          minLength: 1
          type:
          - string
          - 'null'
        ranges:
          items:
            $ref: '#/components/schemas/TikTokTextRange'
          type:
          - array
          - 'null'
      required:
      - field
      - ranges
      type: object
    TikTokServiceCategory:
      additionalProperties: false
      properties:
        code:
          type:
          - integer
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - name
      - code
      type: object
    TikTokSocialLink:
      additionalProperties: false
      properties:
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        platform:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - platform
      - id
      - handle
      - displayName
      - url
      type: object
    TikTokStickerPosition:
      additionalProperties: false
      properties:
        endTime:
          type:
          - number
          - 'null'
        height:
          type:
          - number
          - 'null'
        isRelative:
          type:
          - boolean
          - 'null'
        rotation:
          type:
          - number
          - 'null'
        scale:
          type:
          - number
          - 'null'
        startTime:
          type:
          - number
          - 'null'
        width:
          type:
          - number
          - 'null'
        x:
          type:
          - number
          - 'null'
        y:
          type:
          - number
          - 'null'
      required:
      - x
      - y
      - width
      - height
      - rotation
      - scale
      - isRelative
      - startTime
      - endTime
      type: object
    TikTokStoryCount:
      additionalProperties: false
      properties:
        count:
          type:
          - integer
          - 'null'
        postTypeCode:
          type:
          - integer
          - 'null'
      required:
      - postTypeCode
      - count
      type: object
    TikTokStoryReference:
      additionalProperties: false
      properties:
        expiresAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        mediaTypeCode:
          type:
          - integer
          - 'null'
        postTypeCode:
          type:
          - integer
          - 'null'
      required:
      - id
      - mediaTypeCode
      - postTypeCode
      - expiresAt
      type: object
    TikTokStreamingLink:
      additionalProperties: false
      properties:
        platformCode:
          type:
          - integer
          - 'null'
        songId:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - platformCode
      - songId
      type: object
    TikTokTemplateMetrics:
      additionalProperties: false
      properties:
        clips:
          type:
          - integer
          - 'null'
      required:
      - clips
      type: object
    TikTokTextEntity:
      additionalProperties: false
      properties:
        end:
          type:
          - integer
          - 'null'
        hashtag:
          anyOf:
          - $ref: '#/components/schemas/TikTokHashtagReference'
          - type: 'null'
        start:
          type:
          - integer
          - 'null'
        tagId:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        typeCode:
          type:
          - integer
          - 'null'
        user:
          anyOf:
          - $ref: '#/components/schemas/TikTokProfileReference'
          - type: 'null'
      required:
      - type
      - typeCode
      - start
      - end
      - tagId
      - user
      - hashtag
      type: object
    TikTokTextRange:
      additionalProperties: false
      properties:
        end:
          type:
          - integer
          - 'null'
        start:
          type:
          - integer
          - 'null'
      required:
      - start
      - end
      type: object
    TikTokUnspecified:
      additionalProperties: false
      properties: {}
      type: object
    TikTokVolumeInfo:
      additionalProperties: false
      properties:
        loudness:
          type:
          - number
          - 'null'
        loudnessRange:
          type:
          - number
          - 'null'
        loudnessRangeEnd:
          type:
          - number
          - 'null'
        loudnessRangeStart:
          type:
          - number
          - 'null'
        maxVolume:
          type:
          - number
          - 'null'
        maximumMomentaryLoudness:
          type:
          - number
          - 'null'
        maximumShortTermLoudness:
          type:
          - number
          - 'null'
        meanVolume:
          type:
          - number
          - 'null'
        peak:
          type:
          - number
          - 'null'
        version:
          type:
          - number
          - 'null'
      required:
      - loudness
      - peak
      - loudnessRange
      - loudnessRangeStart
      - loudnessRangeEnd
      - maximumMomentaryLoudness
      - maximumShortTermLoudness
      - version
      - maxVolume
      - meanVolume
      type: object
    TikTokWhatsAppMetrics:
      additionalProperties: false
      properties:
        shares:
          type:
          - integer
          - 'null'
      required:
      - shares
      type: object
    TwitterAppMetrics:
      additionalProperties: false
      properties:
        rating:
          type:
          - number
          - 'null'
        ratings:
          type:
          - integer
          - 'null'
      required:
      - rating
      - ratings
      type: object
    TwitterArticle:
      additionalProperties: false
      properties:
        cover:
          anyOf:
          - $ref: '#/components/schemas/TwitterMedia'
          - type: 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        previewText:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - title
      - previewText
      - cover
      type: object
    TwitterAspectRatio:
      additionalProperties: false
      properties:
        height:
          type: integer
        width:
          type: integer
      required:
      - width
      - height
      type: object
    TwitterBroadcast:
      additionalProperties: false
      properties:
        broadcaster:
          anyOf:
          - $ref: '#/components/schemas/TwitterBroadcaster'
          - type: 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isHighLatency:
          type:
          - boolean
          - 'null'
        media:
          anyOf:
          - $ref: '#/components/schemas/TwitterBroadcastMedia'
          - type: 'null'
        orientationCode:
          type:
          - integer
          - 'null'
        replayEditedStartTime:
          minLength: 1
          type:
          - string
          - 'null'
        scheduledStartAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        source:
          minLength: 1
          type:
          - string
          - 'null'
        state:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - id
      - url
      - title
      - source
      - state
      - isHighLatency
      - width
      - height
      - orientationCode
      - scheduledStartAt
      - media
      - broadcaster
      - replayEditedStartTime
      type: object
    TwitterBroadcastMedia:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        key:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - key
      type: object
    TwitterBroadcaster:
      additionalProperties: false
      properties:
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - handle
      - displayName
      type: object
    TwitterCard:
      additionalProperties: false
      properties:
        apps:
          items:
            $ref: '#/components/schemas/TwitterCardApp'
          type:
          - array
          - 'null'
        broadcast:
          anyOf:
          - $ref: '#/components/schemas/TwitterBroadcast'
          - type: 'null'
        components:
          items:
            $ref: '#/components/schemas/TwitterCardComponent'
          type:
          - array
          - 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        destinations:
          items:
            $ref: '#/components/schemas/TwitterCardDestination'
          type:
          - array
          - 'null'
        displayUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        domain:
          minLength: 1
          type:
          - string
          - 'null'
        event:
          anyOf:
          - $ref: '#/components/schemas/TwitterEvent'
          - type: 'null'
        imageAltText:
          items:
            $ref: '#/components/schemas/TwitterImageAltText'
          type:
          - array
          - 'null'
        images:
          items:
            $ref: '#/components/schemas/TwitterImage'
          type:
          - array
          - 'null'
        layoutType:
          minLength: 1
          type:
          - string
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/TwitterMedia'
          type:
          - array
          - 'null'
        mediaType:
          minLength: 1
          type:
          - string
          - 'null'
        poll:
          anyOf:
          - $ref: '#/components/schemas/TwitterPoll'
          - type: 'null'
        profiles:
          items:
            $ref: '#/components/schemas/TwitterProfileReference'
          type:
          - array
          - 'null'
        publisherId:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - type
      - url
      - profiles
      - title
      - description
      - domain
      - displayUrl
      - mediaType
      - broadcast
      - event
      - publisherId
      - images
      - imageAltText
      - poll
      - layoutType
      - components
      - destinations
      - media
      - apps
      type: object
    TwitterCardApp:
      additionalProperties: false
      properties:
        category:
          anyOf:
          - $ref: '#/components/schemas/TwitterCardText'
          - type: 'null'
        countryCode:
          minLength: 1
          type:
          - string
          - 'null'
        description:
          anyOf:
          - $ref: '#/components/schemas/TwitterCardText'
          - type: 'null'
        groupId:
          minLength: 1
          type:
          - string
          - 'null'
        hasInAppPurchases:
          type:
          - boolean
          - 'null'
        iconKey:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isEditorsChoice:
          type:
          - boolean
          - 'null'
        isFree:
          type:
          - boolean
          - 'null'
        metrics:
          anyOf:
          - $ref: '#/components/schemas/TwitterAppMetrics'
          - type: 'null'
        resolvedUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        sizeBytes:
          type:
          - integer
          - 'null'
        title:
          anyOf:
          - $ref: '#/components/schemas/TwitterCardText'
          - type: 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - groupId
      - id
      - type
      - countryCode
      - url
      - resolvedUrl
      - isEditorsChoice
      - isFree
      - iconKey
      - sizeBytes
      - hasInAppPurchases
      - category
      - title
      - description
      - metrics
      type: object
    TwitterCardButton:
      additionalProperties: false
      properties:
        action:
          minLength: 1
          type:
          - string
          - 'null'
        destinationId:
          minLength: 1
          type:
          - string
          - 'null'
        style:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - action
      - style
      - type
      - destinationId
      type: object
    TwitterCardComponent:
      additionalProperties: false
      properties:
        appGroupId:
          minLength: 1
          type:
          - string
          - 'null'
        buttons:
          items:
            $ref: '#/components/schemas/TwitterCardButton'
          type:
          - array
          - 'null'
        destinationId:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        media:
          items:
            $ref: '#/components/schemas/TwitterCardMediaRef'
          type:
          - array
          - 'null'
        mediaKey:
          minLength: 1
          type:
          - string
          - 'null'
        subtitle:
          anyOf:
          - $ref: '#/components/schemas/TwitterCardText'
          - type: 'null'
        title:
          anyOf:
          - $ref: '#/components/schemas/TwitterCardText'
          - type: 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - type
      - destinationId
      - mediaKey
      - appGroupId
      - title
      - subtitle
      - media
      - buttons
      type: object
    TwitterCardDestination:
      additionalProperties: false
      properties:
        appGroupId:
          minLength: 1
          type:
          - string
          - 'null'
        displayUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        mediaKey:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - type
      - mediaKey
      - appGroupId
      - url
      - displayUrl
      type: object
    TwitterCardMediaRef:
      additionalProperties: false
      properties:
        destinationId:
          minLength: 1
          type:
          - string
          - 'null'
        key:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - key
      - destinationId
      type: object
    TwitterCardText:
      additionalProperties: false
      properties:
        isRightToLeft:
          type:
          - boolean
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      - isRightToLeft
      type: object
    TwitterColor:
      additionalProperties: false
      properties:
        percentage:
          type: number
        rgb:
          $ref: '#/components/schemas/TwitterRGB'
      required:
      - percentage
      - rgb
      type: object
    TwitterCommunityNote:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        presentation:
          anyOf:
          - $ref: '#/components/schemas/TwitterNotePresentation'
          - type: 'null'
        preview:
          anyOf:
          - $ref: '#/components/schemas/TwitterRichText'
          - type: 'null'
        shortTitle:
          minLength: 1
          type:
          - string
          - 'null'
        summary:
          anyOf:
          - $ref: '#/components/schemas/TwitterRichText'
          - type: 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - url
      - title
      - shortTitle
      - summary
      - preview
      - presentation
      type: object
    TwitterConversationContext:
      additionalProperties: false
      properties:
        ancestors:
          items:
            $ref: '#/components/schemas/TwitterPostReference'
          type:
          - array
          - 'null'
        otherPosts:
          items:
            $ref: '#/components/schemas/TwitterPostReference'
          type:
          - array
          - 'null'
        requestedPost:
          anyOf:
          - $ref: '#/components/schemas/TwitterPostReference'
          - type: 'null'
      required:
      - requestedPost
      - ancestors
      - otherPosts
      type: object
    TwitterEdit:
      additionalProperties: false
      properties:
        editableUntil:
          minLength: 1
          type:
          - string
          - 'null'
        historyIds:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        initialPostId:
          minLength: 1
          type:
          - string
          - 'null'
        remaining:
          type:
          - integer
          - 'null'
      required:
      - historyIds
      - editableUntil
      - remaining
      - initialPostId
      type: object
    TwitterEntity:
      additionalProperties: false
      properties:
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        displayUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        mediaId:
          minLength: 1
          type:
          - string
          - 'null'
        range:
          anyOf:
          - $ref: '#/components/schemas/TwitterRange'
          - type: 'null'
        shortUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - type
      - range
      - shortUrl
      - url
      - displayUrl
      - text
      - handle
      - id
      - displayName
      - mediaId
      type: object
    TwitterEvent:
      additionalProperties: false
      properties:
        category:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        subtitle:
          minLength: 1
          type:
          - string
          - 'null'
        timelineId:
          minLength: 1
          type:
          - string
          - 'null'
        title:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - title
      - subtitle
      - category
      - timelineId
      type: object
    TwitterFormatting:
      additionalProperties: false
      properties:
        range:
          $ref: '#/components/schemas/TwitterRange'
        types:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
      required:
      - range
      - types
      type: object
    TwitterImage:
      additionalProperties: false
      properties:
        altText:
          minLength: 1
          type:
          - string
          - 'null'
        height:
          type:
          - integer
          - 'null'
        isNft:
          type:
          - boolean
          - 'null'
        role:
          minLength: 1
          type:
          - string
          - 'null'
        shape:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - type
      - url
      - role
      - width
      - height
      - altText
      - shape
      - isNft
      type: object
    TwitterImageAltText:
      additionalProperties: false
      properties:
        role:
          minLength: 1
          type:
          - string
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - role
      - text
      type: object
    TwitterLabel:
      additionalProperties: false
      properties:
        description:
          anyOf:
          - $ref: '#/components/schemas/TwitterRichText'
          - type: 'null'
        icon:
          anyOf:
          - $ref: '#/components/schemas/TwitterImage'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - type
      - text
      - icon
      - url
      - description
      type: object
    TwitterList:
      additionalProperties: false
      properties:
        banner:
          anyOf:
          - $ref: '#/components/schemas/TwitterImage'
          - type: 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type: string
        metrics:
          $ref: '#/components/schemas/TwitterListMetrics'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        owner:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfileReference'
          - type: 'null'
      required:
      - id
      - name
      - description
      - owner
      - banner
      - metrics
      type: object
    TwitterListMetrics:
      additionalProperties: false
      properties:
        members:
          type:
          - integer
          - 'null'
        subscribers:
          type:
          - integer
          - 'null'
      required:
      - members
      - subscribers
      type: object
    TwitterLongText:
      additionalProperties: false
      properties:
        formatting:
          items:
            $ref: '#/components/schemas/TwitterFormatting'
          type:
          - array
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        inlineMedia:
          items: {}
          type:
          - array
          - 'null'
        isExpandable:
          type:
          - boolean
          - 'null'
        timestamps:
          items: {}
          type:
          - array
          - 'null'
      required:
      - id
      - isExpandable
      - inlineMedia
      - formatting
      - timestamps
      type: object
    TwitterMedia:
      additionalProperties: false
      properties:
        altText:
          minLength: 1
          type:
          - string
          - 'null'
        aspectRatio:
          anyOf:
          - $ref: '#/components/schemas/TwitterAspectRatio'
          - type: 'null'
        availability:
          anyOf:
          - $ref: '#/components/schemas/TwitterMediaAvailability'
          - type: 'null'
        duration:
          type:
          - number
          - 'null'
        features:
          items:
            $ref: '#/components/schemas/TwitterMediaFeature'
          type:
          - array
          - 'null'
        focusRegions:
          items:
            $ref: '#/components/schemas/TwitterRectangle'
          type:
          - array
          - 'null'
        height:
          type:
          - integer
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isAnimated:
          type:
          - boolean
          - 'null'
        isMonetizable:
          type:
          - boolean
          - 'null'
        key:
          minLength: 1
          type:
          - string
          - 'null'
        palette:
          items:
            $ref: '#/components/schemas/TwitterColor'
          type:
          - array
          - 'null'
        restrictions:
          anyOf:
          - $ref: '#/components/schemas/TwitterMediaRestrictions'
          - type: 'null'
        sizes:
          items:
            $ref: '#/components/schemas/TwitterMediaSize'
          type:
          - array
          - 'null'
        source:
          anyOf:
          - $ref: '#/components/schemas/TwitterMediaSource'
          - type: 'null'
        thumbnail:
          anyOf:
          - $ref: '#/components/schemas/TwitterImage'
          - type: 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        variants:
          items:
            $ref: '#/components/schemas/TwitterMediaVariant'
          type:
          - array
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - id
      - type
      - key
      - altText
      - isAnimated
      - source
      - width
      - height
      - focusRegions
      - features
      - sizes
      - duration
      - aspectRatio
      - variants
      - url
      - thumbnail
      - availability
      - restrictions
      - isMonetizable
      - palette
      type: object
    TwitterMediaAvailability:
      additionalProperties: false
      properties:
        status:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - status
      type: object
    TwitterMediaFeature:
      additionalProperties: false
      properties:
        faceRegions:
          items:
            $ref: '#/components/schemas/TwitterRectangle'
          type:
          - array
          - 'null'
        size:
          minLength: 1
          type:
          - string
          - 'null'
        taggedProfiles:
          items:
            $ref: '#/components/schemas/TwitterProfileReference'
          type:
          - array
          - 'null'
      required:
      - size
      - faceRegions
      - taggedProfiles
      type: object
    TwitterMediaRestrictions:
      additionalProperties: false
      properties:
        isDmca:
          type:
          - boolean
          - 'null'
      required:
      - isDmca
      type: object
    TwitterMediaSize:
      additionalProperties: false
      properties:
        height:
          type:
          - integer
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        resizeMode:
          minLength: 1
          type:
          - string
          - 'null'
        width:
          type:
          - integer
          - 'null'
      required:
      - name
      - width
      - height
      - resizeMode
      type: object
    TwitterMediaSource:
      additionalProperties: false
      properties:
        authorId:
          minLength: 1
          type:
          - string
          - 'null'
        postId:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - postId
      - authorId
      type: object
    TwitterMediaVariant:
      additionalProperties: false
      properties:
        bitrate:
          type:
          - integer
          - 'null'
        contentType:
          minLength: 1
          type:
          - string
          - 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - url
      - bitrate
      - contentType
      type: object
    TwitterNotePresentation:
      additionalProperties: false
      properties:
        iconType:
          minLength: 1
          type:
          - string
          - 'null'
        style:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - iconType
      - style
      type: object
    TwitterPageMetadata:
      additionalProperties: false
      properties:
        cashtags:
          items: {}
          type:
          - array
          - 'null'
        context:
          anyOf:
          - $ref: '#/components/schemas/TwitterConversationContext'
          - type: 'null'
        events:
          items: {}
          type:
          - array
          - 'null'
        hashtags:
          items: {}
          type:
          - array
          - 'null'
        lists:
          items: {}
          type:
          - array
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            suggestions:
              type:
              - integer
              - 'null'
          required:
          - suggestions
          type: object
        nextCursorLabel:
          minLength: 1
          type:
          - string
          - 'null'
        nextCursorType:
          minLength: 1
          type:
          - string
          - 'null'
        promoted:
          items:
            $ref: '#/components/schemas/TwitterPostReference'
          type:
          - array
          - 'null'
        queries:
          items:
            $ref: '#/components/schemas/TwitterSuggestedQuery'
          type:
          - array
          - 'null'
        query:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - nextCursorType
      - nextCursorLabel
      - context
      - promoted
      - query
      - metrics
      - queries
      - cashtags
      - hashtags
      - events
      - lists
      type: object
    TwitterPlace:
      additionalProperties: false
      properties:
        country:
          minLength: 1
          type:
          - string
          - 'null'
        countryCode:
          minLength: 1
          type:
          - string
          - 'null'
        fullName:
          minLength: 1
          type:
          - string
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - fullName
      - type
      - country
      - countryCode
      type: object
    TwitterPoll:
      additionalProperties: false
      properties:
        choices:
          items:
            $ref: '#/components/schemas/TwitterPollChoice'
          type:
          - array
          - 'null'
        countsAreFinal:
          type:
          - boolean
          - 'null'
        duration:
          type:
          - integer
          - 'null'
        endsAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            choices:
              type: integer
          required:
          - choices
          type: object
        updatedAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - metrics
      - choices
      - endsAt
      - updatedAt
      - countsAreFinal
      - duration
      type: object
    TwitterPollChoice:
      additionalProperties: false
      properties:
        images:
          items:
            $ref: '#/components/schemas/TwitterImage'
          type:
          - array
          - 'null'
        label:
          minLength: 1
          type:
          - string
          - 'null'
        metrics:
          additionalProperties: false
          properties:
            votes:
              type: integer
          required:
          - votes
          type:
          - object
          - 'null'
        position:
          type: integer
      required:
      - position
      - label
      - metrics
      - images
      type: object
    TwitterPost:
      additionalProperties: false
      properties:
        article:
          anyOf:
          - $ref: '#/components/schemas/TwitterArticle'
          - type: 'null'
        author:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfileReference'
          - type: 'null'
        authorId:
          minLength: 1
          type:
          - string
          - 'null'
        card:
          anyOf:
          - $ref: '#/components/schemas/TwitterCard'
          - type: 'null'
        communityNote:
          anyOf:
          - $ref: '#/components/schemas/TwitterCommunityNote'
          - type: 'null'
        conversationId:
          minLength: 1
          type:
          - string
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type: string
        displayTextRange:
          anyOf:
          - $ref: '#/components/schemas/TwitterRange'
          - type: 'null'
        edit:
          anyOf:
          - $ref: '#/components/schemas/TwitterEdit'
          - type: 'null'
        entities:
          items:
            $ref: '#/components/schemas/TwitterEntity'
          type: array
        hasGrokAnalysisButton:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type: string
        inReplyToHandle:
          minLength: 1
          type:
          - string
          - 'null'
        inReplyToPostId:
          minLength: 1
          type:
          - string
          - 'null'
        inReplyToUserId:
          minLength: 1
          type:
          - string
          - 'null'
        isPromoted:
          type:
          - boolean
          - 'null'
        isQuote:
          type:
          - boolean
          - 'null'
        isRepost:
          type:
          - boolean
          - 'null'
        isSensitive:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        longText:
          anyOf:
          - $ref: '#/components/schemas/TwitterLongText'
          - type: 'null'
        media:
          items:
            $ref: '#/components/schemas/TwitterMedia'
          type: array
        metrics:
          $ref: '#/components/schemas/TwitterPostMetrics'
        preview:
          anyOf:
          - $ref: '#/components/schemas/TwitterPreview'
          - type: 'null'
        previousMetrics:
          anyOf:
          - $ref: '#/components/schemas/TwitterPreviousMetrics'
          - type: 'null'
        promotion:
          anyOf:
          - $ref: '#/components/schemas/TwitterPromotion'
          - type: 'null'
        quotedPost:
          anyOf:
          - $ref: '#/components/schemas/TwitterPostReference'
          - type: 'null'
        quotedPostId:
          minLength: 1
          type:
          - string
          - 'null'
        repostedPost:
          anyOf:
          - $ref: '#/components/schemas/TwitterPostReference'
          - type: 'null'
        restrictions:
          items:
            $ref: '#/components/schemas/TwitterRestriction'
          type:
          - array
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        timeline:
          anyOf:
          - $ref: '#/components/schemas/TwitterTimelinePlacement'
          - type: 'null'
        url:
          format: uri
          minLength: 1
          type: string
      required:
      - id
      - text
      - language
      - isSensitive
      - isQuote
      - createdAt
      - conversationId
      - authorId
      - inReplyToPostId
      - inReplyToUserId
      - inReplyToHandle
      - quotedPostId
      - author
      - url
      - metrics
      - displayTextRange
      - media
      - entities
      - edit
      - hasGrokAnalysisButton
      - communityNote
      - isRepost
      - repostedPost
      - quotedPost
      - preview
      - longText
      - article
      - previousMetrics
      - card
      - restrictions
      - isPromoted
      - promotion
      - timeline
      type: object
    TwitterPostMetrics:
      additionalProperties: false
      properties:
        comments:
          type:
          - integer
          - 'null'
        likes:
          type:
          - integer
          - 'null'
        quotes:
          type:
          - integer
          - 'null'
        reposts:
          type:
          - integer
          - 'null'
        saves:
          type:
          - integer
          - 'null'
        views:
          type:
          - integer
          - 'null'
        viewsState:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - likes
      - comments
      - reposts
      - quotes
      - saves
      - views
      - viewsState
      type: object
    TwitterPostReference:
      additionalProperties: false
      properties:
        article:
          anyOf:
          - $ref: '#/components/schemas/TwitterArticle'
          - type: 'null'
        author:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfileReference'
          - type: 'null'
        authorId:
          minLength: 1
          type:
          - string
          - 'null'
        card:
          anyOf:
          - $ref: '#/components/schemas/TwitterCard'
          - type: 'null'
        communityNote:
          anyOf:
          - $ref: '#/components/schemas/TwitterCommunityNote'
          - type: 'null'
        conversationId:
          minLength: 1
          type:
          - string
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        displayTextRange:
          anyOf:
          - $ref: '#/components/schemas/TwitterRange'
          - type: 'null'
        edit:
          anyOf:
          - $ref: '#/components/schemas/TwitterEdit'
          - type: 'null'
        entities:
          items:
            $ref: '#/components/schemas/TwitterEntity'
          type:
          - array
          - 'null'
        hasGrokAnalysisButton:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        inReplyToHandle:
          minLength: 1
          type:
          - string
          - 'null'
        inReplyToPostId:
          minLength: 1
          type:
          - string
          - 'null'
        inReplyToUserId:
          minLength: 1
          type:
          - string
          - 'null'
        isPromoted:
          type:
          - boolean
          - 'null'
        isQuote:
          type:
          - boolean
          - 'null'
        isRepost:
          type:
          - boolean
          - 'null'
        isSensitive:
          type:
          - boolean
          - 'null'
        language:
          minLength: 1
          type:
          - string
          - 'null'
        longText:
          anyOf:
          - $ref: '#/components/schemas/TwitterLongText'
          - type: 'null'
        media:
          items:
            $ref: '#/components/schemas/TwitterMedia'
          type:
          - array
          - 'null'
        metrics:
          $ref: '#/components/schemas/TwitterPostMetrics'
        preview:
          anyOf:
          - $ref: '#/components/schemas/TwitterPreview'
          - type: 'null'
        previousMetrics:
          anyOf:
          - $ref: '#/components/schemas/TwitterPreviousMetrics'
          - type: 'null'
        promotion:
          anyOf:
          - $ref: '#/components/schemas/TwitterPromotion'
          - type: 'null'
        quotedPost:
          anyOf:
          - $ref: '#/components/schemas/TwitterPostReference'
          - type: 'null'
        quotedPostId:
          minLength: 1
          type:
          - string
          - 'null'
        repostedPost:
          anyOf:
          - $ref: '#/components/schemas/TwitterPostReference'
          - type: 'null'
        restrictions:
          items:
            $ref: '#/components/schemas/TwitterRestriction'
          type:
          - array
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
        timeline:
          anyOf:
          - $ref: '#/components/schemas/TwitterTimelinePlacement'
          - type: 'null'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - text
      - language
      - isSensitive
      - isQuote
      - createdAt
      - conversationId
      - authorId
      - inReplyToPostId
      - inReplyToUserId
      - inReplyToHandle
      - quotedPostId
      - author
      - url
      - metrics
      - displayTextRange
      - media
      - entities
      - edit
      - hasGrokAnalysisButton
      - communityNote
      - isRepost
      - repostedPost
      - quotedPost
      - preview
      - longText
      - article
      - previousMetrics
      - card
      - restrictions
      - isPromoted
      - promotion
      - timeline
      type: object
    TwitterPreview:
      additionalProperties: false
      properties:
        displayTextRange:
          anyOf:
          - $ref: '#/components/schemas/TwitterRange'
          - type: 'null'
        entities:
          items:
            $ref: '#/components/schemas/TwitterEntity'
          type:
          - array
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      - entities
      - displayTextRange
      type: object
    TwitterPreviousMetrics:
      additionalProperties: false
      properties:
        comments:
          type:
          - integer
          - 'null'
        likes:
          type:
          - integer
          - 'null'
        quotes:
          type:
          - integer
          - 'null'
      required:
      - likes
      - quotes
      - comments
      type: object
    TwitterProfessional:
      additionalProperties: false
      properties:
        categories:
          items:
            $ref: '#/components/schemas/TwitterProfessionalCategory'
          type:
          - array
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - type
      - categories
      type: object
    TwitterProfessionalCategory:
      additionalProperties: false
      properties:
        id:
          minLength: 1
          type:
          - string
          - 'null'
        name:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - id
      - name
      type: object
    TwitterProfile:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/TwitterImage'
          - type: 'null'
        banner:
          anyOf:
          - $ref: '#/components/schemas/TwitterImage'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        entities:
          $ref: '#/components/schemas/TwitterProfileEntities'
        externalUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type: string
        hasCustomTimelines:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type: string
        isLifelineInstitution:
          type:
          - boolean
          - 'null'
        isPrivate:
          type:
          - boolean
          - 'null'
        isSuspended:
          type:
          - boolean
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        labels:
          items:
            $ref: '#/components/schemas/TwitterLabel'
          type:
          - array
          - 'null'
        location:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfileLocation'
          - type: 'null'
        metrics:
          $ref: '#/components/schemas/TwitterProfileMetrics'
        pinnedPostIds:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        professional:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfessional'
          - type: 'null'
        subscriptions:
          $ref: '#/components/schemas/TwitterSubscriptions'
        url:
          format: uri
          minLength: 1
          type: string
        verification:
          $ref: '#/components/schemas/TwitterVerification'
        visibility:
          $ref: '#/components/schemas/TwitterVisibility'
        withheld:
          $ref: '#/components/schemas/TwitterWithheld'
      required:
      - id
      - handle
      - displayName
      - bio
      - url
      - externalUrl
      - createdAt
      - location
      - avatar
      - banner
      - isPrivate
      - isSuspended
      - isVerified
      - hasCustomTimelines
      - isLifelineInstitution
      - metrics
      - verification
      - pinnedPostIds
      - entities
      - withheld
      - subscriptions
      - visibility
      - professional
      - labels
      type: object
    TwitterProfileEntities:
      additionalProperties: false
      properties:
        bio:
          items:
            $ref: '#/components/schemas/TwitterEntity'
          type:
          - array
          - 'null'
        externalUrl:
          items:
            $ref: '#/components/schemas/TwitterEntity'
          type:
          - array
          - 'null'
      required:
      - bio
      - externalUrl
      type: object
    TwitterProfileLocation:
      additionalProperties: false
      properties:
        place:
          anyOf:
          - $ref: '#/components/schemas/TwitterPlace'
          - type: 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      - place
      type: object
    TwitterProfileMetrics:
      additionalProperties: false
      properties:
        affiliates:
          type:
          - integer
          - 'null'
        creatorSubscriptions:
          type:
          - integer
          - 'null'
        followers:
          type:
          - integer
          - 'null'
        following:
          type:
          - integer
          - 'null'
        likedPosts:
          type:
          - integer
          - 'null'
        mediaPosts:
          type:
          - integer
          - 'null'
        posts:
          type:
          - integer
          - 'null'
      required:
      - followers
      - following
      - posts
      - likedPosts
      - mediaPosts
      - creatorSubscriptions
      - affiliates
      type: object
    TwitterProfileReference:
      additionalProperties: false
      properties:
        avatar:
          anyOf:
          - $ref: '#/components/schemas/TwitterImage'
          - type: 'null'
        banner:
          anyOf:
          - $ref: '#/components/schemas/TwitterImage'
          - type: 'null'
        bio:
          minLength: 1
          type:
          - string
          - 'null'
        createdAt:
          format: date-time
          minLength: 1
          type:
          - string
          - 'null'
        displayName:
          minLength: 1
          type:
          - string
          - 'null'
        entities:
          $ref: '#/components/schemas/TwitterProfileEntities'
        externalUrl:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        handle:
          minLength: 1
          type:
          - string
          - 'null'
        hasCustomTimelines:
          type:
          - boolean
          - 'null'
        id:
          minLength: 1
          type:
          - string
          - 'null'
        isLifelineInstitution:
          type:
          - boolean
          - 'null'
        isPrivate:
          type:
          - boolean
          - 'null'
        isSuspended:
          type:
          - boolean
          - 'null'
        isVerified:
          type:
          - boolean
          - 'null'
        labels:
          items:
            $ref: '#/components/schemas/TwitterLabel'
          type:
          - array
          - 'null'
        location:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfileLocation'
          - type: 'null'
        metrics:
          $ref: '#/components/schemas/TwitterProfileMetrics'
        pinnedPostIds:
          items:
            minLength: 1
            type: string
          type:
          - array
          - 'null'
        professional:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfessional'
          - type: 'null'
        subscriptions:
          $ref: '#/components/schemas/TwitterSubscriptions'
        url:
          format: uri
          minLength: 1
          type:
          - string
          - 'null'
        verification:
          $ref: '#/components/schemas/TwitterVerification'
        visibility:
          $ref: '#/components/schemas/TwitterVisibility'
        withheld:
          $ref: '#/components/schemas/TwitterWithheld'
      required:
      - id
      - handle
      - displayName
      - bio
      - url
      - externalUrl
      - createdAt
      - location
      - avatar
      - banner
      - isPrivate
      - isSuspended
      - isVerified
      - hasCustomTimelines
      - isLifelineInstitution
      - metrics
      - verification
      - pinnedPostIds
      - entities
      - withheld
      - subscriptions
      - visibility
      - professional
      - labels
      type: object
    TwitterPromotion:
      additionalProperties: false
      properties:
        advertiser:
          anyOf:
          - $ref: '#/components/schemas/TwitterProfileReference'
          - type: 'null'
      required:
      - advertiser
      type: object
    TwitterRGB:
      additionalProperties: false
      properties:
        blue:
          type: integer
        green:
          type: integer
        red:
          type: integer
      required:
      - red
      - green
      - blue
      type: object
    TwitterRange:
      additionalProperties: false
      properties:
        end:
          type: integer
        start:
          type: integer
      required:
      - start
      - end
      type: object
    TwitterRectangle:
      additionalProperties: false
      properties:
        height:
          type:
          - integer
          - 'null'
        width:
          type:
          - integer
          - 'null'
        x:
          type:
          - integer
          - 'null'
        y:
          type:
          - integer
          - 'null'
      required:
      - x
      - y
      - width
      - height
      type: object
    TwitterRestriction:
      additionalProperties: false
      properties:
        action:
          minLength: 1
          type:
          - string
          - 'null'
        message:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - action
      - message
      type: object
    TwitterRichText:
      additionalProperties: false
      properties:
        entities:
          items:
            $ref: '#/components/schemas/TwitterEntity'
          type:
          - array
          - 'null'
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      - entities
      type: object
    TwitterSubscriptions:
      additionalProperties: false
      properties:
        isEligible:
          type:
          - boolean
          - 'null'
      required:
      - isEligible
      type: object
    TwitterSuggestedQuery:
      additionalProperties: false
      properties:
        text:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - text
      type: object
    TwitterTimelinePlacement:
      additionalProperties: false
      properties:
        conversationSection:
          minLength: 1
          type:
          - string
          - 'null'
        displayType:
          minLength: 1
          type:
          - string
          - 'null'
        moduleDisplayType:
          minLength: 1
          type:
          - string
          - 'null'
        position:
          type:
          - integer
          - 'null'
      required:
      - position
      - conversationSection
      - moduleDisplayType
      - displayType
      type: object
    TwitterVerification:
      additionalProperties: false
      properties:
        isBlueVerified:
          type:
          - boolean
          - 'null'
        legacyVerified:
          type:
          - boolean
          - 'null'
        type:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - legacyVerified
      - type
      - isBlueVerified
      type: object
    TwitterVisibility:
      additionalProperties: false
      properties:
        hasHiddenLikesOnProfile:
          type:
          - boolean
          - 'null'
        hasHiddenSubscriptionsOnProfile:
          type:
          - boolean
          - 'null'
      required:
      - hasHiddenLikesOnProfile
      - hasHiddenSubscriptionsOnProfile
      type: object
    TwitterWithheld:
      additionalProperties: false
      properties:
        copyright:
          type:
          - boolean
          - 'null'
        description:
          minLength: 1
          type:
          - string
          - 'null'
        scope:
          minLength: 1
          type:
          - string
          - 'null'
      required:
      - copyright
      - description
      - scope
      type: object
  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.1.0
openapi: 3.1.0
paths:
  /v1/instagram/comments/{identifier}/likers:
    get:
      description: List comment likers from public Instagram data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_comment_likers_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Opaque native media ID associated with the selected resource.
        example: '910100000001'
        in: query
        name: media_id
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfileSummary'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/hashtags/{identifier}:
    get:
      description: Return one public hashtag by its native identifier. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramHashtagGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: syntheticvolume
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramHashtag'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: syntheticvolume
          query: synthetic
  /v1/instagram/hashtags/{identifier}/posts:
    get:
      description: Return a cursor-paginated collection of public posts. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramHashtagPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: syntheticvolume
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: recent
        in: query
        name: sort
        required: false
        schema:
          default: recent
          enum:
          - recent
          - top
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: syntheticvolume
          query: synthetic
  /v1/instagram/hashtags/{identifier}/reels:
    get:
      description: Return a cursor-paginated collection of Instagram reels for a hashtag. Test and Live
        use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable,
        not zero.
      operationId: instagramHashtagReelsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '910100000001'
  /v1/instagram/highlights/{identifier}:
    get:
      description: Get a highlight from public Instagram data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_highlight_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramHighlight'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/locations/{identifier}:
    get:
      description: Return one public location by its native identifier. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramLocationGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000002'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramLocation'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000002'
          query: synthetic
  /v1/instagram/locations/{identifier}/posts:
    get:
      description: Return a cursor-paginated collection of public posts. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramLocationPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000002'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: recent
        in: query
        name: sort
        required: false
        schema:
          default: recent
          enum:
          - recent
          - top
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000002'
          query: synthetic
  /v1/instagram/music/{identifier}:
    get:
      description: Return one public music by its native identifier. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramMusicGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000003'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramMusic'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000003'
          query: synthetic
  /v1/instagram/music/{identifier}/stream:
    get:
      description: List music stream pages from public Instagram data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_music_stream_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramMusicStream'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/posts/{identifier}:
    get:
      description: Get a post by a canonical platform identifier. URLs must be converted before calling
        a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and
        errors. In Test, null means unavailable, not zero.
      operationId: instagramPostGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramPost'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '910100000001'
  /v1/instagram/posts/{identifier}/clip-metadata:
    get:
      description: Get clip metadata from public Instagram data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_post_clip_metadata_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramClipMetadata'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/posts/{identifier}/comment-metadata:
    get:
      description: Get comment metadata from public Instagram data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_post_comment_metadata_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramCommentMetadata'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/posts/{identifier}/comment-moderation:
    get:
      description: Check comment moderation from public Instagram data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_post_comment_moderation_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: 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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/posts/{identifier}/comments:
    get:
      description: List post comments by a canonical platform identifier. URLs must be converted before
        calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination,
        and errors. In Test, null means unavailable, not zero.
      operationId: instagramPostCommentsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramComment'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '910100000001'
  /v1/instagram/posts/{identifier}/comments/{comment_id}/replies:
    get:
      description: Return a stable page of replies for one comment. Use find_test_data to discover compatible
        post and comment IDs. Test and Live use the same route, parameters, response schema, pagination,
        and errors. In Test, null means unavailable, not zero.
      operationId: instagramCommentRepliesList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Opaque native comment ID.
        example: '910200000001'
        in: path
        name: comment_id
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramComment'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment_id: '910200000001'
          identifier: '910100000001'
          post_id: '910100000001'
  /v1/instagram/posts/{identifier}/insights:
    get:
      description: Get post insights from public Instagram data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_post_insights_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramPostInsight'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/posts/{identifier}/likers:
    get:
      description: Return public profiles that liked an Instagram post. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramPostLikersList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '910100000001'
  /v1/instagram/posts/{identifier}/oembed:
    get:
      description: Get post oEmbed data from public Instagram data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_post_oembed_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramOEmbed'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/posts/{identifier}/tagged-users:
    get:
      description: Return public profiles tagged in an Instagram post. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramPostTaggedUsersList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramUserTag'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '910100000001'
  /v1/instagram/posts/{identifier}/template:
    get:
      description: Get post template from public Instagram data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_post_template_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramTemplate'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/profiles/{identifier}:
    get:
      description: Return one public profile. Use @username or a platform ID as the identifier. Test and
        Live use the same route, parameters, response schema, pagination, and errors. In Test, null means
        unavailable, not zero.
      operationId: instagramProfileGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramProfile'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
  /v1/instagram/profiles/{identifier}/about:
    get:
      description: Get profile about information from public Instagram data. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: Instagram_profile_about_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramProfileAbout'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '@northstar_forge_test'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/profiles/{identifier}/business-recommendations:
    get:
      description: List business recommendations from public Instagram data. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: Instagram_profile_business_recommendations_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfileSummary'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '@northstar_forge_test'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/profiles/{identifier}/followers:
    get:
      description: Return a cursor-paginated collection of Instagram profiles. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: instagramProfileFollowersList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
  /v1/instagram/profiles/{identifier}/followers/search:
    get:
      description: Search within a public profile's followers collection. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramProfileFollowersSearch
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
          query: synthetic
  /v1/instagram/profiles/{identifier}/following:
    get:
      description: Return a cursor-paginated collection of Instagram profiles. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: instagramProfileFollowingList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
  /v1/instagram/profiles/{identifier}/following/search:
    get:
      description: Search within a public profile's following collection. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramProfileFollowingSearch
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
          query: synthetic
  /v1/instagram/profiles/{identifier}/highlights:
    get:
      description: List profile highlights from public Instagram data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_profile_highlights_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramHighlight'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '@northstar_forge_test'
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/profiles/{identifier}/pinned-posts:
    get:
      description: Return a cursor-paginated 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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
  /v1/instagram/profiles/{identifier}/posts:
    get:
      description: Return a stable page of posts for one public profile. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramProfilePostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      - description: Return posts captured at or after this RFC 3339 timestamp.
        in: query
        name: since
        required: false
        schema:
          format: date-time
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
  /v1/instagram/profiles/{identifier}/stories:
    get:
      description: List profile stories from public Instagram data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_profile_stories_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@northstar_forge_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramStory'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@northstar_forge_test'
  /v1/instagram/search/hashtags:
    get:
      description: Search public Instagram hashtags with cursor pagination. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: instagramSearchHashtags
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramHashtag'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/instagram/search/music:
    get:
      description: Search public Instagram music with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramSearchMusic
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramMusic'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/instagram/search/places:
    get:
      description: Search public Instagram places with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramSearchPlaces
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramLocation'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/instagram/search/profiles:
    get:
      description: Search public Instagram profiles with cursor pagination. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: instagramSearchProfiles
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/instagram/search/reels:
    get:
      description: Search public Instagram reels with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: instagramSearchReels
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/instagram/search/top:
    get:
      description: Search all Instagram results from public Instagram data. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: Instagram_search_top_list
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/InstagramSearchResult'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          media_id: '910100000001'
          query: synthetic
  /v1/instagram/stories/{identifier}:
    get:
      description: Get a story from public Instagram data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Instagram_story_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '910100000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/InstagramStory'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment: synthetic comment
          identifier: '910100000001'
          media_id: '910100000001'
          query: synthetic
  /v1/reddit/domains/{identifier}/posts:
    get:
      description: List domain posts from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_domain_posts_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: example.com
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: hot
        in: query
        name: sort
        required: false
        schema:
          default: hot
          enum:
          - hot
          - new
          - top
          - rising
          - controversial
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: t
        required: false
        schema:
          enum:
          - hour
          - day
          - week
          - month
          - year
          - all
          type: string
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List domain posts
      tags:
      - Reddit
      - Post
      x-openhandle-operation: reddit.domain.posts.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.domain.posts.list
        scope:
        - name: reddit
        - name: domain
          parameter: identifier
          reference: domain
        - name: posts
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.domain.posts.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: example.com
          page: index
          query: synthetic
  /v1/reddit/posts/{identifier}:
    get:
      description: Get a post from public Reddit data. Test and Live use the same route, parameters, response
        schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_post_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/RedditPost'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: Get a post
      tags:
      - Reddit
      - Post
      x-openhandle-operation: reddit.post.get
      x-openhandle-sdk:
        operation: get
        paginated: false
        path: reddit.post.get
        scope:
        - name: reddit
        - name: post
          parameter: identifier
          reference: post
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.post.get
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/posts/{identifier}/comments:
    get:
      description: List post comments from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_post_comments_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: confidence
        in: query
        name: sort
        required: false
        schema:
          default: confidence
          enum:
          - confidence
          - top
          - new
          - controversial
          - old
          - qa
          type: string
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: depth
        required: false
        schema:
          maximum: 10
          minimum: 0
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditComment'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List post comments
      tags:
      - Reddit
      - Comment
      x-openhandle-operation: reddit.post.comments.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.post.comments.list
        scope:
        - name: reddit
        - name: post
          parameter: identifier
          reference: post
        - name: comments
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.post.comments.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/posts/{identifier}/duplicates:
    get:
      description: List duplicate posts from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_post_duplicates_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List duplicate posts
      tags:
      - Reddit
      - Post
      x-openhandle-operation: reddit.post.duplicates.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.post.duplicates.list
        scope:
        - name: reddit
        - name: post
          parameter: identifier
          reference: post
        - name: duplicates
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.post.duplicates.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/profiles/{identifier}:
    get:
      description: Return one public Reddit profile. Use @username or a t2_ profile ID. An ID resolves
        only after the profile was read by username once. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_profile_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@synthetic_reddit'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/RedditProfile'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: Get a profile
      tags:
      - Reddit
      - Profile
      x-openhandle-operation: reddit.profile.get
      x-openhandle-sdk:
        operation: get
        paginated: false
        path: reddit.profile.get
        scope:
        - name: reddit
        - name: profile
          parameter: identifier
          reference: profile
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.profile.get
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@synthetic_reddit'
  /v1/reddit/profiles/{identifier}/comments:
    get:
      description: List profile comments from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_profile_comments_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@synthetic_reddit'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: new
        in: query
        name: sort
        required: false
        schema:
          default: new
          enum:
          - new
          - hot
          - top
          - controversial
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: t
        required: false
        schema:
          enum:
          - hour
          - day
          - week
          - month
          - year
          - all
          type: string
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditComment'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List profile comments
      tags:
      - Reddit
      - Comment
      x-openhandle-operation: reddit.profile.comments.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.profile.comments.list
        scope:
        - name: reddit
        - name: profile
          parameter: identifier
          reference: profile
        - name: comments
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.profile.comments.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@synthetic_reddit'
          page: index
          query: synthetic
  /v1/reddit/profiles/{identifier}/moderated:
    get:
      description: List moderated subreddits from public Reddit data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_profile_moderated_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@synthetic_reddit'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditSubreddit'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List moderated subreddits
      tags:
      - Reddit
      - Subreddit
      x-openhandle-operation: reddit.profile.moderated.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.profile.moderated.list
        scope:
        - name: reddit
        - name: profile
          parameter: identifier
          reference: profile
        - name: moderated
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.profile.moderated.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@synthetic_reddit'
          page: index
          query: synthetic
  /v1/reddit/profiles/{identifier}/posts:
    get:
      description: List profile posts from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_profile_posts_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@synthetic_reddit'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: new
        in: query
        name: sort
        required: false
        schema:
          default: new
          enum:
          - new
          - hot
          - top
          - controversial
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: t
        required: false
        schema:
          enum:
          - hour
          - day
          - week
          - month
          - year
          - all
          type: string
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List profile posts
      tags:
      - Reddit
      - Post
      x-openhandle-operation: reddit.profile.posts.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.profile.posts.list
        scope:
        - name: reddit
        - name: profile
          parameter: identifier
          reference: profile
        - name: posts
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.profile.posts.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@synthetic_reddit'
          page: index
          query: synthetic
  /v1/reddit/profiles/{identifier}/trophies:
    get:
      description: List profile trophies from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_profile_trophies_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@synthetic_reddit'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - 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/RedditTrophy'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List profile trophies
      tags:
      - Reddit
      - Trophy
      x-openhandle-operation: reddit.profile.trophies.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.profile.trophies.list
        scope:
        - name: reddit
        - name: profile
          parameter: identifier
          reference: profile
        - name: trophies
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.profile.trophies.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@synthetic_reddit'
          page: index
          query: synthetic
  /v1/reddit/search/posts:
    get:
      description: Search posts from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_search_posts_list
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: relevance
        in: query
        name: sort
        required: false
        schema:
          default: relevance
          enum:
          - relevance
          - hot
          - top
          - new
          - comments
          type: string
      - description: Provider-specific public-data filter for this operation.
        example: synthetic
        in: query
        name: subreddit
        required: false
        schema:
          minLength: 1
          type: string
      - description: Provider-specific public-data filter for this operation.
        example: synthetic
        in: query
        name: t
        required: false
        schema:
          enum:
          - hour
          - day
          - week
          - month
          - year
          - all
          type: string
      - description: Maximum number of results to return.
        example: synthetic
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: Search posts
      tags:
      - Reddit
      - Post
      x-openhandle-operation: reddit.search.posts.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.search.posts.list
        scope:
        - name: reddit
        - name: search
        - name: posts
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.search.posts.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          page: index
          query: synthetic
  /v1/reddit/search/profiles:
    get:
      description: Search profiles from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_search_profiles_list
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum number of results to return.
        example: synthetic
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: Search profiles
      tags:
      - Reddit
      - Profile
      x-openhandle-operation: reddit.search.profiles.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.search.profiles.list
        scope:
        - name: reddit
        - name: search
        - name: profiles
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.search.profiles.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          page: index
          query: synthetic
  /v1/reddit/search/subreddits:
    get:
      description: Search subreddits from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_search_subreddits_list
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum number of results to return.
        example: synthetic
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditSubreddit'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: Search subreddits
      tags:
      - Reddit
      - Subreddit
      x-openhandle-operation: reddit.search.subreddits.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.search.subreddits.list
        scope:
        - name: reddit
        - name: search
        - name: subreddits
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.search.subreddits.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          page: index
          query: synthetic
  /v1/reddit/subreddits/new:
    get:
      description: List new subreddits from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_subreddits_new_list
      parameters:
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditSubreddit'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List new subreddits
      tags:
      - Reddit
      - Subreddit
      x-openhandle-operation: reddit.subreddits.new.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.subreddits.new.list
        scope:
        - name: reddit
        - name: subreddits
        - name: new
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.subreddits.new.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          handle: synthetic_reddit
          id: synthetic
          page: index
          q: synthetic
          query: synthetic
  /v1/reddit/subreddits/popular:
    get:
      description: List popular subreddits from public Reddit data. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_subreddits_popular_list
      parameters:
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditSubreddit'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List popular subreddits
      tags:
      - Reddit
      - Subreddit
      x-openhandle-operation: reddit.subreddits.popular.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.subreddits.popular.list
        scope:
        - name: reddit
        - name: subreddits
        - name: popular
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.subreddits.popular.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          handle: synthetic_reddit
          id: synthetic
          page: index
          q: synthetic
          query: synthetic
  /v1/reddit/subreddits/{identifier}:
    get:
      description: Get a subreddit from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_subreddit_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/RedditSubreddit'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: Get a subreddit
      tags:
      - Reddit
      - Subreddit
      x-openhandle-operation: reddit.subreddit.get
      x-openhandle-sdk:
        operation: get
        paginated: false
        path: reddit.subreddit.get
        scope:
        - name: reddit
        - name: subreddit
          parameter: identifier
          reference: subreddit
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.subreddit.get
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/subreddits/{identifier}/posts:
    get:
      description: List subreddit posts from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_subreddit_posts_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: hot
        in: query
        name: sort
        required: false
        schema:
          default: hot
          enum:
          - hot
          - new
          - top
          - rising
          - controversial
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: t
        required: false
        schema:
          enum:
          - hour
          - day
          - week
          - month
          - year
          - all
          type: string
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List subreddit posts
      tags:
      - Reddit
      - Post
      x-openhandle-operation: reddit.subreddit.posts.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.subreddit.posts.list
        scope:
        - name: reddit
        - name: subreddit
          parameter: identifier
          reference: subreddit
        - name: posts
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.subreddit.posts.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/subreddits/{identifier}/rules:
    get:
      description: List subreddit rules from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_subreddit_rules_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - 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/RedditRule'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List subreddit rules
      tags:
      - Reddit
      - Rule
      x-openhandle-operation: reddit.subreddit.rules.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.subreddit.rules.list
        scope:
        - name: reddit
        - name: subreddit
          parameter: identifier
          reference: subreddit
        - name: rules
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.subreddit.rules.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/subreddits/{identifier}/wiki-pages:
    get:
      description: List wiki pages from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_subreddit_wiki_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - 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/RedditWikiPage'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List wiki pages
      tags:
      - Reddit
      - Wiki
      x-openhandle-operation: reddit.subreddit.wiki.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.subreddit.wikiPages.list
        scope:
        - name: reddit
        - name: subreddit
          parameter: identifier
          reference: subreddit
        - name: wikiPages
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.subreddit.wiki.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/subreddits/{identifier}/wiki-pages/{page}:
    get:
      description: Get a wiki page from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_subreddit_wiki_page_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: synthetic
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Provider-specific public-data filter for this operation.
        example: index
        in: path
        name: page
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/RedditWikiPage'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: Get a wiki page
      tags:
      - Reddit
      - Wiki
      x-openhandle-operation: reddit.subreddit.wiki.page.get
      x-openhandle-sdk:
        operation: get
        paginated: false
        path: reddit.subreddit.wikiPage.get
        scope:
        - name: reddit
        - name: subreddit
          parameter: identifier
          reference: subreddit
        - name: wikiPage
          parameter: page
          reference: wikiPage
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.subreddit.wiki.page.get
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: synthetic
          page: index
          query: synthetic
  /v1/reddit/trending/posts:
    get:
      description: List trending posts from public Reddit data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Reddit_trending_posts_list
      parameters:
      - description: Result ordering for this operation.
        example: hot
        in: query
        name: sort
        required: false
        schema:
          default: hot
          enum:
          - hot
          - new
          - top
          - rising
          - controversial
          - best
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: t
        required: false
        schema:
          enum:
          - hour
          - day
          - week
          - month
          - year
          - all
          type: string
      - description: Maximum number of results to return.
        in: query
        name: limit
        required: false
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/RedditPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
      security:
      - OpenhandleKey: []
      summary: List trending posts
      tags:
      - Reddit
      - Post
      x-openhandle-operation: reddit.trending.posts.list
      x-openhandle-sdk:
        operation: list
        paginated: true
        path: reddit.trending.posts.list
        scope:
        - name: reddit
        - name: trending
        - name: posts
      x-openhandle-test-data:
        catalogUrl: /v1/test-data?operation=reddit.trending.posts.list
        contentHash: sha256:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          handle: synthetic_reddit
          id: synthetic
          page: index
          q: synthetic
          query: synthetic
  /v1/test-data:
    get:
      description: Public, unmetered discovery. Filter by platform, resource, operation, traits, expected
        status, error code, or text.
      operationId: listTestData
      parameters:
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: platform
        required: false
        schema:
          enum:
          - instagram
          - tiktok
          - twitter
          - reddit
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: resource
        required: false
        schema:
          enum:
          - profile
          - post
          - comment
          - hashtag
          - location
          - music
          - category
          - list
          - entity
          - subreddit
          - rule
          - wiki
          - trophy
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: operation
        required: false
        schema:
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: traits
        required: false
        schema:
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: status
        required: false
        schema:
          type: integer
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: errorCode
        required: false
        schema:
          type: string
      - description: Provider-specific public-data filter for this operation.
        in: query
        name: search
        required: false
        schema:
          type: string
      - description: Maximum number of results to return.
        example: '100'
        in: query
        name: limit
        required: false
        schema:
          default: 100
          maximum: 100
          minimum: 1
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TestDataCatalogEnvelope'
          description: Matching catalog entries for the active dataset version.
      summary: Search the synthetic test-data catalog
      x-openhandle-sdk:
        operation: list
        paginated: false
        path: testData.list
        scope:
        - name: testData
  /v1/test-data/{id}:
    get:
      operationId: getTestData
      parameters:
      - description: Provider-specific public-data filter for this operation.
        example: instagram.profile.northstar-forge
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TestDataEntryEnvelope'
          description: The catalog entry.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageEnvelope'
          description: The catalog entry does not exist.
      summary: Get one synthetic catalog entry
      x-openhandle-sdk:
        operation: get
        paginated: false
        path: testData.entry.get
        scope:
        - name: testData
        - name: entry
          parameter: id
          reference: testDataEntry
  /v1/tiktok/effects:
    get:
      description: Get effects in a batch from public Tiktok data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Tiktok_effects_list
      parameters:
      - description: Comma-separated opaque native IDs.
        example: '950000000007'
        in: query
        name: ids
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokEffect'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          category_id: '950000000008'
          comment: synthetic
          comment_id: '920200000000000001'
          ids: '950000000007'
          playlist_id: '950000000006'
          post_id: '920100000000000001'
          product_source_type: '0'
          query: synthetic
          rank_type: daily
          room_id: '950000000009'
          user_id: '920000000001'
  /v1/tiktok/effects/{identifier}:
    get:
      description: Get an effect from public Tiktok data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Tiktok_effect_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '920100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokEffect'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          category_id: '950000000008'
          comment: synthetic
          comment_id: '920200000000000001'
          identifier: '920100000000000001'
          ids: '950000000007'
          playlist_id: '950000000006'
          post_id: '920100000000000001'
          product_source_type: '0'
          query: synthetic
          rank_type: daily
          room_id: '950000000009'
          user_id: '920000000001'
  /v1/tiktok/effects/{identifier}/posts:
    get:
      description: Return a cursor-paginated collection of TikTok posts that use an effect. Test and Live
        use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable,
        not zero.
      operationId: tiktokEffectPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '920100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '920100000000000001'
  /v1/tiktok/hashtags/{identifier}:
    get:
      description: Return one public hashtag by its native identifier. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokHashtagGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokHashtag'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000001'
          query: synthetic
  /v1/tiktok/hashtags/{identifier}/posts:
    get:
      description: Return a cursor-paginated collection of public posts. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokHashtagPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000001'
          query: synthetic
  /v1/tiktok/locations/{identifier}:
    get:
      description: Return one public location by its native identifier. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokLocationGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000002'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokLocation'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000002'
          query: synthetic
  /v1/tiktok/locations/{identifier}/posts:
    get:
      description: Return a cursor-paginated collection of public posts. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokLocationPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000002'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000002'
          query: synthetic
  /v1/tiktok/music/{identifier}:
    get:
      description: Return one public music by its native identifier. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokMusicGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000003'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokMusic'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000003'
          query: synthetic
  /v1/tiktok/music/{identifier}/posts:
    get:
      description: Return a cursor-paginated collection of public posts. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokMusicPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000003'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000003'
          query: synthetic
  /v1/tiktok/posts/{identifier}:
    get:
      description: Get a post by a canonical platform identifier. URLs must be converted before calling
        a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and
        errors. In Test, null means unavailable, not zero.
      operationId: tiktokPostGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '920100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokPost'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '920100000000000001'
  /v1/tiktok/posts/{identifier}/comments:
    get:
      description: List post comments by a canonical platform identifier. URLs must be converted before
        calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination,
        and errors. In Test, null means unavailable, not zero.
      operationId: tiktokPostCommentsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '920100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokComment'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '920100000000000001'
  /v1/tiktok/posts/{identifier}/comments/{comment_id}/replies:
    get:
      description: Return a stable page of replies for one comment. Use find_test_data to discover compatible
        post and comment IDs. Test and Live use the same route, parameters, response schema, pagination,
        and errors. In Test, null means unavailable, not zero.
      operationId: tiktokCommentRepliesList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '920100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Opaque native comment ID.
        example: '920200000000000001'
        in: path
        name: comment_id
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokComment'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment_id: '920200000000000001'
          identifier: '920100000000000001'
          post_id: '920100000000000001'
  /v1/tiktok/profiles/{identifier}:
    get:
      description: Return one public profile. Use @username or a platform ID as the identifier. Test and
        Live use the same route, parameters, response schema, pagination, and errors. In Test, null means
        unavailable, not zero.
      operationId: tiktokProfileGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@pixel_orchard_tt_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokProfile'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@pixel_orchard_tt_test'
  /v1/tiktok/profiles/{identifier}/followers:
    get:
      description: Return a cursor-paginated collection of Tiktok profiles. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: tiktokProfileFollowersList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@pixel_orchard_tt_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@pixel_orchard_tt_test'
  /v1/tiktok/profiles/{identifier}/following:
    get:
      description: Return a cursor-paginated collection of Tiktok profiles. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: tiktokProfileFollowingList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@pixel_orchard_tt_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@pixel_orchard_tt_test'
  /v1/tiktok/profiles/{identifier}/playlists:
    get:
      description: List profile playlists from public Tiktok data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Tiktok_profile_playlists_list
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@pixel_orchard_tt_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPlaylist'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          category_id: '950000000008'
          comment: synthetic
          comment_id: '920200000000000001'
          identifier: '@pixel_orchard_tt_test'
          ids: '950000000007'
          playlist_id: '950000000006'
          post_id: '920100000000000001'
          product_source_type: '0'
          query: synthetic
          rank_type: daily
          room_id: '950000000009'
          user_id: '920000000001'
  /v1/tiktok/profiles/{identifier}/playlists/{playlist_id}:
    get:
      description: Get a playlist from public Tiktok data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Tiktok_profile_playlist_get
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@pixel_orchard_tt_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Opaque native playlist ID.
        example: '950000000006'
        in: path
        name: playlist_id
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokPlaylist'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          category_id: '950000000008'
          comment: synthetic
          comment_id: '920200000000000001'
          identifier: '@pixel_orchard_tt_test'
          ids: '950000000007'
          playlist_id: '950000000006'
          post_id: '920100000000000001'
          product_source_type: '0'
          query: synthetic
          rank_type: daily
          room_id: '950000000009'
          user_id: '920000000001'
  /v1/tiktok/profiles/{identifier}/playlists/{playlist_id}/posts:
    get:
      description: Return a cursor-paginated collection of posts in a public TikTok profile playlist.
        Test and Live use the same route, parameters, response schema, pagination, and errors. In Test,
        null means unavailable, not zero.
      operationId: tiktokProfilePlaylistPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@pixel_orchard_tt_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Opaque native playlist ID.
        example: '950000000006'
        in: path
        name: playlist_id
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@pixel_orchard_tt_test'
          playlist_id: '950000000006'
  /v1/tiktok/profiles/{identifier}/posts:
    get:
      description: Return a stable page of posts for one public profile. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokProfilePostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@pixel_orchard_tt_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      - description: Return posts captured at or after this RFC 3339 timestamp.
        in: query
        name: since
        required: false
        schema:
          format: date-time
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@pixel_orchard_tt_test'
  /v1/tiktok/search/hashtags:
    get:
      description: Search public Tiktok hashtags with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokSearchHashtags
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokHashtag'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/tiktok/search/locations:
    get:
      description: Search public Tiktok locations with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokSearchLocations
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokLocation'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/tiktok/search/music:
    get:
      description: Search public Tiktok music with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokSearchMusic
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokMusic'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/tiktok/search/posts:
    get:
      description: Search public Tiktok posts with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokSearchPosts
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/tiktok/search/profiles:
    get:
      description: Search public Tiktok profiles with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokSearchProfiles
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/tiktok/trending/categories:
    get:
      description: Return TikTok trending categories. Test and Live use the same route, parameters, response
        schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokTrendingCategoriesList
      parameters:
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokCategory'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          id: '950000000004'
          query: ''
  /v1/tiktok/trending/music:
    get:
      description: Return TikTok's public Top 50 music chart for the configured provider region. Test
        and Live use the same route, parameters, response schema, pagination, and errors. In Test, null
        means unavailable, not zero.
      operationId: tiktokTrendingMusicList
      parameters:
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TikTokMusic'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          id: '950000000003'
          q: synthetic
          query: synthetic
  /v1/tiktok/trending/posts:
    get:
      description: Return TikTok's public recommended feed. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: tiktokTrendingPostsList
      parameters:
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TikTokPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          handle: pixel_orchard_tt_test
          id: '920100000000000001'
          platform_id: '920000000001'
          query: ''
          url: https://www.tiktok.com/@pixel_orchard_tt_test/video/920100000000000001
  /v1/twitter/lists/{identifier}/posts:
    get:
      description: Return the cursor-paginated timeline for a Twitter list. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: twitterListPostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '950000000005'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '950000000005'
  /v1/twitter/posts/{identifier}:
    get:
      description: Get a post by a canonical platform identifier. URLs must be converted before calling
        a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and
        errors. In Test, null means unavailable, not zero.
      operationId: twitterPostGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '940100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TwitterPost'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '940100000000000001'
  /v1/twitter/posts/{identifier}/comments:
    get:
      description: List post comments by a canonical platform identifier. URLs must be converted before
        calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination,
        and errors. In Test, null means unavailable, not zero.
      operationId: twitterPostCommentsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '940100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '940100000000000001'
  /v1/twitter/posts/{identifier}/comments/{comment_id}/replies:
    get:
      description: Return a stable page of replies for one comment. Use find_test_data to discover compatible
        post and comment IDs. Test and Live use the same route, parameters, response schema, pagination,
        and errors. In Test, null means unavailable, not zero.
      operationId: twitterCommentRepliesList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '940100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Opaque native comment ID.
        example: '940200000000000001'
        in: path
        name: comment_id
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          comment_id: '940200000000000001'
          identifier: '940100000000000001'
          post_id: '940100000000000001'
  /v1/twitter/posts/{identifier}/reposters:
    get:
      description: Return public profiles that interacted with a Twitter post. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: twitterPostRepostersList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '940100000000000001'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '940100000000000001'
  /v1/twitter/profiles/{identifier}:
    get:
      description: Return one public profile. Use @username or a platform ID as the identifier. Test and
        Live use the same route, parameters, response schema, pagination, and errors. In Test, null means
        unavailable, not zero.
      operationId: twitterProfileGet
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@copperfield_lab_x_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      $ref: '#/components/schemas/TwitterProfile'
                  required:
                  - data
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@copperfield_lab_x_test'
  /v1/twitter/profiles/{identifier}/followers:
    get:
      description: Return a cursor-paginated collection of Twitter profiles. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: twitterProfileFollowersList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@copperfield_lab_x_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@copperfield_lab_x_test'
  /v1/twitter/profiles/{identifier}/following:
    get:
      description: Return a cursor-paginated collection of Twitter profiles. Test and Live use the same
        route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not
        zero.
      operationId: twitterProfileFollowingList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@copperfield_lab_x_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@copperfield_lab_x_test'
  /v1/twitter/profiles/{identifier}/posts:
    get:
      description: Return a stable page of posts for one public profile. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: twitterProfilePostsList
      parameters:
      - description: Public resource reference. Profile paths accept a username with an @ prefix, such
          as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.
        example: '@copperfield_lab_x_test'
        in: path
        name: identifier
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      - description: Return posts captured at or after this RFC 3339 timestamp.
        in: query
        name: since
        required: false
        schema:
          format: date-time
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        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
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          identifier: '@copperfield_lab_x_test'
  /v1/twitter/search/media:
    get:
      description: Search public Twitter media with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: twitterSearchMedia
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Media type filter.
        example: image
        in: query
        name: type
        required: true
        schema:
          enum:
          - image
          - video
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/twitter/search/posts:
    get:
      description: Search public Twitter posts with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: twitterSearchPosts
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Result ordering for this operation.
        example: latest
        in: query
        name: sort
        required: false
        schema:
          default: latest
          enum:
          - latest
          - top
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterPost'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/twitter/search/suggestions:
    get:
      description: Search suggestions from public Twitter data. Test and Live use the same route, parameters,
        response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: Twitter_search_suggestions_list
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/twitter/search/users:
    get:
      description: Search public Twitter users with cursor pagination. Test and Live use the same route,
        parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.
      operationId: twitterSearchUsers
      parameters:
      - description: Public search query.
        example: synthetic
        in: query
        name: q
        required: true
        schema:
          minLength: 1
          type: string
      - description: Maximum accepted data age. The default is 24h.
        example: 24h
        in: query
        name: freshness
        required: false
        schema:
          default: 24h
          enum:
          - live
          - 24h
          - 7d
          - 30d
          type: string
      - description: Opaque cursor returned by the previous page.
        in: query
        name: cursor
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/TwitterProfile'
                      type: array
                  required:
                  - data
                  - meta
                  type: object
          description: A successful Test or Live response.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
        datasetVersion: 2026-09-07.2
        example:
          query: synthetic
  /v1/urls/fetch:
    post:
      description: Parse a supported social URL locally, then return the same typed resource as its canonical
        Openhandle operation. TikTok short links such as tiktok.com/t/… and vm.tiktok.com/… are expanded
        through their redirect first. The underlying data read is metered once.
      operationId: fetchSocialURL
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                freshness:
                  default: 24h
                  enum:
                  - live
                  - 24h
                  - 7d
                  - 30d
                  type: string
                url:
                  description: Supported social URL, with or without an https:// scheme.
                  minLength: 1
                  type: string
              required:
              - url
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                oneOf:
                - allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - properties:
                      data:
                        $ref: '#/components/schemas/InstagramProfile'
                      platform:
                        const: instagram
                      resource:
                        const: profile
                    required:
                    - platform
                    - resource
                    - data
                    type: object
                - allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - properties:
                      data:
                        $ref: '#/components/schemas/InstagramPost'
                      platform:
                        const: instagram
                      resource:
                        const: post
                    required:
                    - platform
                    - resource
                    - data
                    type: object
                - allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - properties:
                      data:
                        $ref: '#/components/schemas/InstagramStory'
                      platform:
                        const: instagram
                      resource:
                        const: 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
                - allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - properties:
                      data:
                        $ref: '#/components/schemas/RedditProfile'
                      platform:
                        const: reddit
                      resource:
                        const: profile
                    required:
                    - platform
                    - resource
                    - data
                    type: object
                - allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - properties:
                      data:
                        $ref: '#/components/schemas/RedditPost'
                      platform:
                        const: reddit
                      resource:
                        const: post
                    required:
                    - platform
                    - resource
                    - data
                    type: object
                - allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - properties:
                      data:
                        $ref: '#/components/schemas/RedditSubreddit'
                      platform:
                        const: reddit
                      resource:
                        const: subreddit
                    required:
                    - platform
                    - resource
                    - data
                    type: object
          description: The typed profile, post, story, or highlight represented by the URL.
          headers:
            Content-Location:
              description: Canonical Openhandle path for the resolved resource.
              schema:
                type: string
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The locator, cursor, or query is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The API key is invalid.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Live billing does not permit this request.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource is private or workspace API access is security-suspended.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The resource does not exist.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request rate limit was exceeded.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The request failed internally.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying a throttled request. Present on 429 responses.
              example: '1'
              schema:
                type: string
            X-Request-ID:
              description: Stable request identifier.
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: The service is temporarily unavailable.
          headers:
            Openhandle-Billing-Disposition:
              description: Accounting disposition.
              schema:
                enum:
                - test
                - allowance
                - free
                - prepaid
                type: string
            Openhandle-Cost:
              description: Authoritative actual customer charge. Always 0.000 for Test.
              schema:
                type: string
            Openhandle-Dataset-Version:
              description: Synthetic dataset version. Present for Test.
              schema:
                type: string
            Openhandle-Environment:
              description: Environment selected by the API key.
              schema:
                enum:
                - test
                - live
                type: string
            Openhandle-List-Price:
              description: Live-equivalent list price.
              schema:
                type: string
            RateLimit:
              description: Remaining requests (r) and seconds until reset (t) for each evaluated policy.
                May be absent before authentication or when the limiter is unavailable.
              example: '"key";r=9;t=1, "organization";r=49;t=1'
              schema:
                type: string
            RateLimit-Policy:
              description: Quota policies for the evaluated limits. Present after rate-limit evaluation.
                Uses draft-ietf-httpapi-ratelimit-headers-11.
              example: '"key";q=10;w=1, "organization";q=50;w=1'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait 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:b5b99db8b0b9435d04d230483c54f5accfaa44dfa2cd12962a02e03739edfab0
  datasetVersion: 2026-09-07.2
x-openhandle-versioning-policy: https://openhandle.dev/docs/versioning