> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bridgly.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List Reels related to a Reel

> List the Reels Instagram recommends after a given Reel, with captions, media links, publish times, engagement counts, owner details and audio. Continue with nextCursor. Recommendations change between requests. Costs 1 credit per request.



## OpenAPI

````yaml /openapi.json post /instagram/related-reels
openapi: 3.1.0
info:
  title: Bridgly API
  description: >-
    Web scraping API for LinkedIn, X (Twitter), Reddit, GitHub, Instagram and
    TikTok. Authenticated endpoints accept a Bridgly API key (`bgly_…`) via
    `Authorization: Bearer <token>`.
  version: 1.0.0
servers:
  - url: https://api.bridgly.app
    description: Production
security: []
tags:
  - name: LinkedIn
    description: Scrape LinkedIn profiles, companies, posts, and search.
  - name: Reddit
    description: Scrape Reddit posts, subreddits, users, and search.
  - name: X (Twitter)
    description: Scrape tweets and search X.
  - name: GitHub
    description: >-
      Fetch GitHub profiles, pinned repos, contributions, repositories, stars,
      and projects via GitHub's GraphQL API.
  - name: Instagram
    description: Scrape Instagram profiles, posts, followers, and search.
  - name: TikTok
    description: Fetch TikTok profiles.
  - name: Meta Ads
    description: >-
      Search the Meta Ad Library: ads, ad details, and advertisers on Facebook
      and Instagram.
paths:
  /instagram/related-reels:
    post:
      tags:
        - Instagram
      summary: List Reels related to a Reel
      description: >-
        List the Reels Instagram recommends after a given Reel, with captions,
        media links, publish times, engagement counts, owner details and audio.
        Continue with nextCursor. Recommendations change between requests. Costs
        1 credit per request.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                shortcode:
                  type: string
                  minLength: 1
                  description: >-
                    Post shortcode, or the post or Reel link, e.g. "DA1b2C3d4E5"
                    or "https://www.instagram.com/p/DA1b2C3d4E5/".
                count:
                  default: 10
                  description: Number of results to return (1–10). Defaults to 10.
                  type: integer
                  minimum: 1
                  maximum: 10
                cursor:
                  description: >-
                    The previous response's `nextCursor`, to fetch the next
                    page. Omit it for the first page.
                  type: string
                cacheMaxAgeHours:
                  description: >-
                    Accept a cached result scraped up to this many hours ago. A
                    cached result costs no credits, and its `cachedAt` says when
                    it was scraped. When no cached result is that recent, the
                    data is scraped live at the normal price. Leave it out to
                    always scrape live, e.g. 24.
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
                cacheOnly:
                  description: >-
                    Return only a cached result and never scrape live. With
                    `cacheMaxAgeHours`, only a result that recent is returned;
                    without it, the latest cached result of any age. Responds
                    404, at no cost, when there is none, e.g. true.
                  type: boolean
              required:
                - shortcode
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  timeMs:
                    type: number
                    description: >-
                      Wall-clock time the request took to complete, in
                      milliseconds.
                  creditsCost:
                    type: number
                    description: Number of account credits this request consumed.
                  cachedAt:
                    anyOf:
                      - type: string
                        format: date-time
                        pattern: >-
                          ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                      - type: 'null'
                    description: >-
                      When the returned data was scraped, if it came from the
                      cache. Null when it was scraped live for this request.
                  data:
                    type: object
                    properties:
                      nextCursor:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: >-
                          Pass as `cursor` to fetch the next page; null when
                          there are no more results. A page can hold fewer
                          results than asked for, so keep paging until it is
                          null. Fetch the next page soon: a cursor starting with
                          `bridgly_page_` stays valid for a day, and a list that
                          changes in between can shift results across pages.
                      posts:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            type:
                              anyOf:
                                - type: string
                                  enum:
                                    - Image
                                    - Video
                                    - Carousel
                                - type: 'null'
                            display_url:
                              anyOf:
                                - type: string
                                - type: 'null'
                            video_url:
                              anyOf:
                                - type: string
                                - type: 'null'
                            width:
                              anyOf:
                                - type: number
                                - type: 'null'
                            height:
                              anyOf:
                                - type: number
                                - type: 'null'
                            video_duration:
                              description: Video duration in seconds.
                              anyOf:
                                - type: number
                                - type: 'null'
                            accessibility_caption:
                              anyOf:
                                - type: string
                                - type: 'null'
                            image_versions:
                              anyOf:
                                - type: array
                                  items:
                                    type: object
                                    properties:
                                      url:
                                        type: string
                                      width:
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      height:
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                    required:
                                      - url
                                    additionalProperties: false
                                - type: 'null'
                            video_versions:
                              anyOf:
                                - type: array
                                  items:
                                    type: object
                                    properties:
                                      url:
                                        type: string
                                      width:
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      height:
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      type:
                                        description: Instagram video rendition type.
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                    required:
                                      - url
                                    additionalProperties: false
                                - type: 'null'
                            has_audio:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                            video_dash_manifest:
                              description: MPEG-DASH playback manifest.
                              anyOf:
                                - type: string
                                - type: 'null'
                            number_of_qualities:
                              anyOf:
                                - type: number
                                - type: 'null'
                            carousel_parent_id:
                              anyOf:
                                - type: string
                                - type: 'null'
                            user_tags:
                              anyOf:
                                - type: array
                                  items:
                                    type: object
                                    properties:
                                      user:
                                        type: object
                                        properties:
                                          id:
                                            type: string
                                          username:
                                            anyOf:
                                              - type: string
                                              - type: 'null'
                                          full_name:
                                            anyOf:
                                              - type: string
                                              - type: 'null'
                                          profile_pic_url:
                                            anyOf:
                                              - type: string
                                              - type: 'null'
                                          is_private:
                                            anyOf:
                                              - type: boolean
                                              - type: 'null'
                                          is_verified:
                                            anyOf:
                                              - type: boolean
                                              - type: 'null'
                                          profile_pic_id:
                                            anyOf:
                                              - type: string
                                              - type: 'null'
                                          latest_reel_media:
                                            description: >-
                                              Latest story publish time as Unix
                                              seconds; zero means no recent story.
                                            anyOf:
                                              - type: number
                                              - type: 'null'
                                          is_mentionable:
                                            anyOf:
                                              - type: boolean
                                              - type: 'null'
                                        required:
                                          - id
                                        additionalProperties: false
                                      position:
                                        description: >-
                                          Tag coordinates relative to the image
                                          width and height.
                                        anyOf:
                                          - type: array
                                            items:
                                              type: number
                                          - type: 'null'
                                    required:
                                      - user
                                    additionalProperties: false
                                - type: 'null'
                            shortcode:
                              anyOf:
                                - type: string
                                - type: 'null'
                            url:
                              anyOf:
                                - type: string
                                - type: 'null'
                            caption:
                              anyOf:
                                - type: string
                                - type: 'null'
                            likes:
                              anyOf:
                                - type: number
                                - type: 'null'
                            comments:
                              anyOf:
                                - type: number
                                - type: 'null'
                            timestamp:
                              anyOf:
                                - type: number
                                - type: 'null'
                            is_video:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                            video_view_count:
                              anyOf:
                                - type: number
                                - type: 'null'
                            owner:
                              anyOf:
                                - type: object
                                  properties:
                                    id:
                                      type: string
                                    username:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    full_name:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    profile_pic_url:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    is_private:
                                      anyOf:
                                        - type: boolean
                                        - type: 'null'
                                    is_verified:
                                      anyOf:
                                        - type: boolean
                                        - type: 'null'
                                    profile_pic_id:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    latest_reel_media:
                                      description: >-
                                        Latest story publish time as Unix
                                        seconds; zero means no recent story.
                                      anyOf:
                                        - type: number
                                        - type: 'null'
                                    is_mentionable:
                                      anyOf:
                                        - type: boolean
                                        - type: 'null'
                                  required:
                                    - id
                                  additionalProperties: false
                                - type: 'null'
                            carousel_media:
                              anyOf:
                                - type: array
                                  items:
                                    type: object
                                    properties:
                                      id:
                                        type: string
                                      type:
                                        anyOf:
                                          - type: string
                                            enum:
                                              - Image
                                              - Video
                                              - Carousel
                                          - type: 'null'
                                      display_url:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      video_url:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      width:
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      height:
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      video_duration:
                                        description: Video duration in seconds.
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      accessibility_caption:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      image_versions:
                                        anyOf:
                                          - type: array
                                            items:
                                              type: object
                                              properties:
                                                url:
                                                  type: string
                                                width:
                                                  anyOf:
                                                    - type: number
                                                    - type: 'null'
                                                height:
                                                  anyOf:
                                                    - type: number
                                                    - type: 'null'
                                              required:
                                                - url
                                              additionalProperties: false
                                          - type: 'null'
                                      video_versions:
                                        anyOf:
                                          - type: array
                                            items:
                                              type: object
                                              properties:
                                                url:
                                                  type: string
                                                width:
                                                  anyOf:
                                                    - type: number
                                                    - type: 'null'
                                                height:
                                                  anyOf:
                                                    - type: number
                                                    - type: 'null'
                                                type:
                                                  description: Instagram video rendition type.
                                                  anyOf:
                                                    - type: number
                                                    - type: 'null'
                                              required:
                                                - url
                                              additionalProperties: false
                                          - type: 'null'
                                      has_audio:
                                        anyOf:
                                          - type: boolean
                                          - type: 'null'
                                      video_dash_manifest:
                                        description: MPEG-DASH playback manifest.
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      number_of_qualities:
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      carousel_parent_id:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      user_tags:
                                        anyOf:
                                          - type: array
                                            items:
                                              type: object
                                              properties:
                                                user:
                                                  type: object
                                                  properties:
                                                    id:
                                                      type: string
                                                    username:
                                                      anyOf:
                                                        - type: string
                                                        - type: 'null'
                                                    full_name:
                                                      anyOf:
                                                        - type: string
                                                        - type: 'null'
                                                    profile_pic_url:
                                                      anyOf:
                                                        - type: string
                                                        - type: 'null'
                                                    is_private:
                                                      anyOf:
                                                        - type: boolean
                                                        - type: 'null'
                                                    is_verified:
                                                      anyOf:
                                                        - type: boolean
                                                        - type: 'null'
                                                    profile_pic_id:
                                                      anyOf:
                                                        - type: string
                                                        - type: 'null'
                                                    latest_reel_media:
                                                      description: >-
                                                        Latest story publish time as Unix
                                                        seconds; zero means no recent story.
                                                      anyOf:
                                                        - type: number
                                                        - type: 'null'
                                                    is_mentionable:
                                                      anyOf:
                                                        - type: boolean
                                                        - type: 'null'
                                                  required:
                                                    - id
                                                  additionalProperties: false
                                                position:
                                                  description: >-
                                                    Tag coordinates relative to the image
                                                    width and height.
                                                  anyOf:
                                                    - type: array
                                                      items:
                                                        type: number
                                                    - type: 'null'
                                              required:
                                                - user
                                              additionalProperties: false
                                          - type: 'null'
                                    required:
                                      - id
                                    additionalProperties: false
                                - type: 'null'
                            caption_id:
                              anyOf:
                                - type: string
                                - type: 'null'
                            caption_created_at:
                              description: Caption creation time as Unix seconds.
                              anyOf:
                                - type: number
                                - type: 'null'
                            caption_is_edited:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                            caption_has_translation:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                            product_type:
                              anyOf:
                                - type: string
                                - type: 'null'
                            play_count:
                              anyOf:
                                - type: number
                                - type: 'null'
                            comments_disabled:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                            like_and_view_counts_disabled:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                            is_paid_partnership:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                            coauthors:
                              anyOf:
                                - type: array
                                  items:
                                    type: object
                                    properties:
                                      id:
                                        type: string
                                      username:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      full_name:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      profile_pic_url:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      is_private:
                                        anyOf:
                                          - type: boolean
                                          - type: 'null'
                                      is_verified:
                                        anyOf:
                                          - type: boolean
                                          - type: 'null'
                                      profile_pic_id:
                                        anyOf:
                                          - type: string
                                          - type: 'null'
                                      latest_reel_media:
                                        description: >-
                                          Latest story publish time as Unix
                                          seconds; zero means no recent story.
                                        anyOf:
                                          - type: number
                                          - type: 'null'
                                      is_mentionable:
                                        anyOf:
                                          - type: boolean
                                          - type: 'null'
                                    required:
                                      - id
                                    additionalProperties: false
                                - type: 'null'
                            pinned_user_ids:
                              description: Profiles where this post is pinned.
                              anyOf:
                                - type: array
                                  items:
                                    type: string
                                - type: 'null'
                            carousel_media_count:
                              anyOf:
                                - type: number
                                - type: 'null'
                            location:
                              anyOf:
                                - type: object
                                  properties:
                                    id:
                                      type: string
                                    name:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    slug:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    url:
                                      type: string
                                    latitude:
                                      anyOf:
                                        - type: number
                                        - type: 'null'
                                    longitude:
                                      anyOf:
                                        - type: number
                                        - type: 'null'
                                    category:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    posts_count:
                                      anyOf:
                                        - type: number
                                        - type: 'null'
                                    address:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    city:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    postal_code:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    phone:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    price_range:
                                      description: >-
                                        Instagram’s numeric price range for the
                                        place.
                                      anyOf:
                                        - type: number
                                        - type: 'null'
                                    hours_status:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                  required:
                                    - id
                                    - url
                                  additionalProperties: false
                                - type: 'null'
                            audio:
                              anyOf:
                                - type: object
                                  properties:
                                    id:
                                      type: string
                                      description: >-
                                        Audio ID. Pass this to getAudio or
                                        getAudioReels.
                                    url:
                                      type: string
                                    type:
                                      description: >-
                                        Kind of audio as Instagram labels it,
                                        e.g. "licensed_music" or
                                        "original_sounds".
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    title:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    artist:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                  required:
                                    - id
                                    - url
                                  additionalProperties: false
                                - type: 'null'
                            shares:
                              description: Number of times the post was shared.
                              anyOf:
                                - type: number
                                - type: 'null'
                            reposts:
                              description: >-
                                Number of times the post was reposted to
                                followers.
                              anyOf:
                                - type: number
                                - type: 'null'
                            top_likers:
                              description: Usernames of a few accounts that liked the post.
                              anyOf:
                                - type: array
                                  items:
                                    type: string
                                - type: 'null'
                            ai_label:
                              anyOf:
                                - type: object
                                  properties:
                                    text:
                                      description: >-
                                        Label Instagram shows on the post, e.g.
                                        "AI info".
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    detection_method:
                                      description: >-
                                        How Instagram decided the post is
                                        AI-made, e.g. "AI_CREATED" or
                                        "CLASSIFIER_SCORE_HIGH".
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                    is_self_disclosed:
                                      description: >-
                                        Whether the creator labeled the post as
                                        AI-made themselves.
                                      anyOf:
                                        - type: boolean
                                        - type: 'null'
                                  additionalProperties: false
                                - type: 'null'
                          required:
                            - id
                          additionalProperties: false
                    required:
                      - nextCursor
                      - posts
                    additionalProperties: false
                required:
                  - timeMs
                  - creditsCost
                  - cachedAt
                  - data
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '402':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: typescript
          label: Bridgly SDK
          source: |-
            import { Bridgly } from '@bridgly/sdk';

            const client = new Bridgly({ apiKey: process.env.BRIDGLY_API_KEY });

            const res = await client.instagram.getRelatedReels({
              shortcode: "string",
              count: 10,
            });
            if (res.type === 'success') console.log(res.data);
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A Bridgly API key (`bgly_…`). Metered endpoints deduct credits from the
        resolved account.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.