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

# Instagram-posts list

> List an Instagram account's posts, newest first: id (the media_id a post creative needs), link, type, date, caption and counts. Only Instagram accounts this ad account can advertise with are readable. Pass permalink to find one post from its link instead of reading pages.

CLI: `adside meta instagram-posts list`



## OpenAPI

````yaml /api-reference/openapi.yaml post /v1/workspaces/{workspaceId}/meta/instagram-posts/list
openapi: 3.1.0
info:
  title: Adside API
  version: 1.0.0
  description: >-
    Campaigns, creatives, assets and reporting across your ad accounts. Call it
    with a personal API key as a bearer token, or with the `adside` CLI: each
    page names its command.
servers:
  - url: https://api.adside.ai
    description: Production
security:
  - userAccess: []
tags:
  - name: Account
  - name: Reporting
  - name: Meta
  - name: Google Ads
  - name: LinkedIn
  - name: TikTok
  - name: Reddit
  - name: Snapchat
  - name: X
  - name: Google Tag Manager
  - name: Creatives
  - name: Creative styles
  - name: Media
  - name: Characters
  - name: Assets
  - name: Brands
  - name: Brain
  - name: Research
  - name: Boards
  - name: Artifacts
  - name: Audiences
  - name: Ad comments
  - name: Publications
  - name: Routines
  - name: Skills
  - name: To-dos
  - name: Audit
  - name: Credits
paths:
  /v1/workspaces/{workspaceId}/meta/instagram-posts/list:
    post:
      tags:
        - Meta
      summary: Instagram-posts list
      description: >-
        List an Instagram account's posts, newest first: id (the media_id a post
        creative needs), link, type, date, caption and counts. Only Instagram
        accounts this ad account can advertise with are readable. Pass permalink
        to find one post from its link instead of reading pages.


        CLI: `adside meta instagram-posts list`
      operationId: meta.list_instagram_posts
      parameters:
        - name: workspaceId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                account_id:
                  description: Meta Ad Account ID (uses configured account if not provided)
                  type: string
                instagram_account_id:
                  description: >-
                    Instagram account whose posts to list (the
                    instagram_account_id `adside meta account-pages get`
                    reports). Optional when the ad account reaches exactly one
                    Instagram account.
                  type: string
                permalink:
                  description: >-
                    A post's link (https://www.instagram.com/p/… or /reel/…).
                    Finds that post among up to 250 recent posts instead of
                    listing a page; when it is older, the answer's next_cursor
                    continues the search as after.
                  type: string
                  format: uri
                limit:
                  default: 25
                  description: Posts per page, newest first
                  type: integer
                  minimum: 1
                  maximum: 50
                after:
                  description: >-
                    Pagination cursor: the next page, or where a permalink
                    search continues
                  type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
      security:
        - userAccess: []
components:
  securitySchemes:
    userAccess:
      type: http
      scheme: bearer
      description: >-
        A personal API key (`adside_pat_…`) or a token from `adside login`.
        Either carries the permissions of the person it belongs to.

````

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