> ## Documentation Index > Fetch the complete documentation index at: https://docs.clipstake.com/llms.txt > Use this file to discover all available pages before exploring further. # List the posts of an Instagram account > Returns recent Reels and feed videos of one of your Instagram accounts, newest first. Send a post's `media_id` to `POST /clips`. Each request uses the account's Instagram rate limit, which ClipStake also uses to count views. When the limit is near, the API returns 429 and `Retry-After`. An X account, or an account that is not yours, returns 404. ## OpenAPI ````yaml /creator-api/openapi.json get /accounts/{account_id}/media openapi: 3.1.0 info: title: Clipstake Creator API description: >- Submit your Instagram and X posts as clips to the campaigns that ClipStake opened to your account, and follow your clips. version: 0.1.0 servers: - url: https://app.clipstake.com/api/v1/creator security: [] paths: /accounts/{account_id}/media: get: tags: - Accounts summary: List the posts of an Instagram account description: >- Returns recent Reels and feed videos of one of your Instagram accounts, newest first. Send a post's `media_id` to `POST /clips`. Each request uses the account's Instagram rate limit, which ClipStake also uses to count views. When the limit is near, the API returns 429 and `Retry-After`. An X account, or an account that is not yours, returns 404. operationId: accounts-media parameters: - in: path name: account_id schema: type: string description: >- Account ID. Format: acct_ followed by 32 lowercase hexadecimal characters. example: acct_1c2d3e4f5a6b4c7d8e9f0a1b2c3d4e5f required: true description: >- Account ID. Format: acct_ followed by 32 lowercase hexadecimal characters. - in: query name: limit schema: default: 25 description: >- How many posts to read, from 1 to 50. The default is 25. A page can hold fewer items, because posts that are not videos are left out. example: 25 type: integer minimum: 1 maximum: 50 - in: query name: cursor schema: type: string description: The `next_cursor` from the previous page of the same account. example: eyJhIjoiYWNjdCIsImMiOiJRVkZJVXpsWSJ9 responses: '200': description: Successful response content: application/json: schema: type: object properties: data: type: array items: type: object properties: media_id: type: string description: >- The ID of the post on Instagram. Send it as `media_id` to `POST /clips`. example: '17912345678901234' permalink: description: The public link to the post. example: https://www.instagram.com/reel/C9xYz12AbCd/ type: - string - 'null' caption: description: The caption of the post. example: Autumn roast, first sip. type: - string - 'null' thumbnail_url: description: A preview image of the post. The link can expire. example: >- https://cdn.clipstake.example/thumbnails/C9xYz12AbCd.jpg type: - string - 'null' posted_at: 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 post was published. example: '2026-09-18T17:05:00.000Z' like_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Likes on the post now. example: 2600 comments_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Comments on the post now. example: 140 submitted: type: boolean description: >- True when the post is already a clip. `POST /clips` refuses it with 409. example: false required: - media_id - permalink - caption - thumbnail_url - posted_at - like_count - comments_count - submitted additionalProperties: false description: >- A recent Instagram post that you can submit as a clip: a Reel or a feed video. next_cursor: description: >- Send this as `cursor` to get the next page. It is null on the last page. type: - string - 'null' required: - data - next_cursor additionalProperties: false example: data: - media_id: '17912345678901234' permalink: https://www.instagram.com/reel/C9xYz12AbCd/ caption: Autumn roast, first sip. thumbnail_url: https://cdn.clipstake.example/thumbnails/C9xYz12AbCd.jpg posted_at: '2026-09-18T17:05:00.000Z' like_count: 2600 comments_count: 140 submitted: true - media_id: '17923456789012345' permalink: https://www.instagram.com/reel/C9zAb34CdEf/ caption: Grinding the new roast. thumbnail_url: https://cdn.clipstake.example/thumbnails/C9zAb34CdEf.jpg posted_at: '2026-09-19T09:40:00.000Z' like_count: 310 comments_count: 12 submitted: false next_cursor: eyJhIjoiM2Y5YzBhMWIyYzNkIiwiYyI6IlFWRkpWVnBzIn0 '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/error.BAD_REQUEST' example: error: code: invalid_request message: >- The cursor is not valid for this account. Start again without a cursor. request_id: 6f1c2a9e-4b7d-4c1a-9e2f-3a8b5c7d9e10 '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' example: error: code: unauthorized message: >- Provide a valid API key as `Authorization: Bearer cc_live_...`. request_id: 0b7e4d2c-9a1f-4e3b-8c6d-5f2a1b9c7e34 '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/error.NOT_FOUND' example: error: code: not_found message: No such Instagram account. request_id: 3c9a8b7d-2e1f-4a6b-9c8d-7e6f5a4b3c21 '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/error.CONFLICT' example: error: code: conflict message: >- Instagram access has expired. Reconnect your account to continue. request_id: 7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d '429': description: Too many requests content: application/json: schema: $ref: '#/components/schemas/error.TOO_MANY_REQUESTS' example: error: code: rate_limited message: >- This Instagram account is near its rate limit. Try again after the time in `Retry-After`. request_id: 8d2e1f3a-6b5c-4d7e-9f8a-1b2c3d4e5f67 '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR' example: error: code: internal_error message: An unexpected error occurred. request_id: 5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c19 '503': description: Service unavailable content: application/json: schema: $ref: '#/components/schemas/error.SERVICE_UNAVAILABLE' example: error: code: unavailable message: >- Could not load the posts of this account. Try again in a few minutes. request_id: 9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b security: - Authorization: [] components: schemas: error.BAD_REQUEST: type: object title: Bad request error (400) description: The error envelope every failed request returns. properties: error: type: object properties: code: type: string enum: - invalid_request description: A stable, machine-readable error code. message: type: string description: What went wrong, in words a person can act on. request_id: type: string description: The id of this request. Quote it when you contact support. required: - code - message - request_id additionalProperties: false required: - error additionalProperties: false error.UNAUTHORIZED: type: object title: Unauthorized error (401) description: The error envelope every failed request returns. properties: error: type: object properties: code: type: string enum: - unauthorized description: A stable, machine-readable error code. message: type: string description: What went wrong, in words a person can act on. request_id: type: string description: The id of this request. Quote it when you contact support. required: - code - message - request_id additionalProperties: false required: - error additionalProperties: false error.NOT_FOUND: type: object title: Not found error (404) description: The error envelope every failed request returns. properties: error: type: object properties: code: type: string enum: - not_found description: A stable, machine-readable error code. message: type: string description: What went wrong, in words a person can act on. request_id: type: string description: The id of this request. Quote it when you contact support. required: - code - message - request_id additionalProperties: false required: - error additionalProperties: false error.CONFLICT: type: object title: Conflict error (409) description: The error envelope every failed request returns. properties: error: type: object properties: code: type: string enum: - conflict description: A stable, machine-readable error code. message: type: string description: What went wrong, in words a person can act on. request_id: type: string description: The id of this request. Quote it when you contact support. required: - code - message - request_id additionalProperties: false required: - error additionalProperties: false error.TOO_MANY_REQUESTS: type: object title: Too many requests error (429) description: The error envelope every failed request returns. properties: error: type: object properties: code: type: string enum: - rate_limited description: A stable, machine-readable error code. message: type: string description: What went wrong, in words a person can act on. request_id: type: string description: The id of this request. Quote it when you contact support. required: - code - message - request_id additionalProperties: false required: - error additionalProperties: false error.INTERNAL_SERVER_ERROR: type: object title: Internal server error error (500) description: The error envelope every failed request returns. properties: error: type: object properties: code: type: string enum: - internal_error description: A stable, machine-readable error code. message: type: string description: What went wrong, in words a person can act on. request_id: type: string description: The id of this request. Quote it when you contact support. required: - code - message - request_id additionalProperties: false required: - error additionalProperties: false error.SERVICE_UNAVAILABLE: type: object title: Service unavailable error (503) description: The error envelope every failed request returns. properties: error: type: object properties: code: type: string enum: - unavailable description: A stable, machine-readable error code. message: type: string description: What went wrong, in words a person can act on. request_id: type: string description: The id of this request. Quote it when you contact support. required: - code - message - request_id additionalProperties: false required: - error additionalProperties: false securitySchemes: Authorization: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.