> ## 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. # Put a media under tracking ## OpenAPI ````yaml /openapi.json post /submissions openapi: 3.1.0 info: title: Pulse API description: Instagram media tracking, audience geography and demographics, as an API. version: 0.0.0 servers: - url: https://api.clipstake.com/v1 security: [] paths: /submissions: post: tags: - Submissions summary: Put a media under tracking operationId: submissions-create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: project_id: type: string minLength: 1 maxLength: 36 username: type: string minLength: 1 maxLength: 255 urls: minItems: 1 maxItems: 100 type: array items: type: string maxLength: 2048 required: - project_id - username - urls responses: '200': description: Successful response content: application/json: schema: type: object properties: data: type: array items: type: object properties: shortcode: type: string status: type: string enum: - created - already_tracked - not_found submission: anyOf: - type: object properties: username: type: string external_user_id: type: string media_id: type: string shortcode: type: string media_product_type: 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' status: type: string enum: - active - paused - unavailable - parked - stopped next_read_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' unavailable_reason: type: - string - 'null' parked_reason: type: - string - 'null' latest: type: object properties: views: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' reach: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' likes: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' comments: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' shares: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' saves: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' total_interactions: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - views - reach - likes - comments - shares - saves - total_interactions additionalProperties: false latest_captured_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' created_at: 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))$ required: - username - external_user_id - media_id - shortcode - media_product_type - posted_at - status - next_read_at - unavailable_reason - parked_reason - created_at additionalProperties: false - type: 'null' required: - shortcode - status - submission additionalProperties: false required: - data additionalProperties: false example: data: - shortcode: C9x4AbCdEfG status: created submission: username: acme.studio external_user_id: customer_8f3a2c19 media_id: '18062712345678901' shortcode: C9x4AbCdEfG media_product_type: REELS posted_at: '2026-09-10T14:22:00.000Z' status: active next_read_at: '2026-09-14T14:00:00.000Z' unavailable_reason: null parked_reason: null latest: views: 128450 reach: 96720 likes: 8140 comments: 326 shares: 1190 saves: 2480 total_interactions: 12136 latest_captured_at: '2026-09-14T10:00:00.000Z' created_at: '2026-09-10T14:25:43.000Z' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/error.BAD_REQUEST' example: error: code: invalid_request message: The request body or parameters are invalid. request_id: req_01K5A7N8QY2M4C6V9X3J '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' example: error: code: unauthorized message: Provide a valid API key. request_id: req_01K5A7P2CH8T6R4W9M1B '402': description: Payment required content: application/json: schema: $ref: '#/components/schemas/error.PAYMENT_REQUIRED' example: error: code: quota_exceeded message: >- This workspace has reached its submission limit. Upgrade on the Billing page to keep adding. request_id: req_01K5A7P8VM2T6R4W9C3H '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/error.NOT_FOUND' example: error: code: not_found message: The requested resource was not found. request_id: req_01K5A7R4WM9C2N6B8X3D '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/error.CONFLICT' example: error: code: conflict message: >- Instagram media discovery is already running for this account. Try again in 2 seconds. request_id: req_01K5A7T3MX8C2V6B9N4P '429': description: Too many requests content: application/json: schema: $ref: '#/components/schemas/error.TOO_MANY_REQUESTS' example: error: code: rate_limited message: Instagram is rate-limiting this account. Try again later. request_id: req_01K5A7S2JT5B9W3M7R1F '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: req_01K5A7S6FQ3V8H2N9C4M security: - Authorization: [] components: schemas: error.BAD_REQUEST: type: object properties: message: type: string description: The error message example: Bad request code: type: string description: The error code example: BAD_REQUEST issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Bad request error (400) description: The error information example: code: BAD_REQUEST message: Bad request issues: [] error.UNAUTHORIZED: type: object properties: message: type: string description: The error message example: Unauthorized code: type: string description: The error code example: UNAUTHORIZED issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Unauthorized error (401) description: The error information example: code: UNAUTHORIZED message: Unauthorized issues: [] error.PAYMENT_REQUIRED: type: object properties: message: type: string description: The error message example: Payment required code: type: string description: The error code example: PAYMENT_REQUIRED issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Payment required error (402) description: The error information example: code: PAYMENT_REQUIRED message: Payment required issues: [] error.NOT_FOUND: type: object properties: message: type: string description: The error message example: Not found code: type: string description: The error code example: NOT_FOUND issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Not found error (404) description: The error information example: code: NOT_FOUND message: Not found issues: [] error.CONFLICT: type: object properties: message: type: string description: The error message example: Conflict code: type: string description: The error code example: CONFLICT issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Conflict error (409) description: The error information example: code: CONFLICT message: Conflict issues: [] error.TOO_MANY_REQUESTS: type: object properties: message: type: string description: The error message example: Too many requests code: type: string description: The error code example: TOO_MANY_REQUESTS issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Too many requests error (429) description: The error information example: code: TOO_MANY_REQUESTS message: Too many requests issues: [] error.INTERNAL_SERVER_ERROR: type: object properties: message: type: string description: The error message example: Internal server error code: type: string description: The error code example: INTERNAL_SERVER_ERROR issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Internal server error error (500) description: The error information example: code: INTERNAL_SERVER_ERROR message: Internal server error issues: [] securitySchemes: Authorization: type: http scheme: bearer ````