{"openapi":"3.1.0","info":{"title":"Clipstake API","description":"Instagram, X and YouTube media tracking, audience geography and demographics, as an API.","version":"0.0.1"},"servers":[{"url":"https://api.clipstake.com/v1"}],"paths":{"/instagram/accounts":{"get":{"operationId":"instagram-accounts-list","summary":"List connected social accounts","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"external_user_id","schema":{"type":"string"}},{"in":"query","name":"username","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"id":"acct_3f9c0a1b2c3d4e5f60718293","platform":"instagram","platform_user_id":"17841400008460056","username":"acme.studio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":{"status":"active","parked_reason":null,"next_read_at":"2026-09-15T02:00:00.000Z"},"capabilities":["media_stats","media_comments","media_demographics","account_insights","account_audience"],"metadata":{"segment":"creator"},"latest_as_of":"2026-09-14T00:00:00.000Z","connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.000Z"}],"next_cursor":null}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/accounts/list-connected-social-accounts"}}},"/instagram/accounts/{account_id}":{"get":{"operationId":"instagram-accounts-get","summary":"Get an account","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false},"example":{"id":"acct_3f9c0a1b2c3d4e5f60718293","platform":"instagram","platform_user_id":"17841400008460056","username":"acme.studio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":{"status":"active","parked_reason":null,"next_read_at":"2026-09-15T02:00:00.000Z"},"capabilities":["media_stats","media_comments","media_demographics","account_insights","account_audience"],"metadata":{"segment":"creator"},"latest_as_of":"2026-09-14T00:00:00.000Z","connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/accounts/get-an-account"}},"patch":{"operationId":"instagram-accounts-update","summary":"Update account metadata","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},{"type":"null"}]}},"required":["metadata"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false},"example":{"id":"acct_3f9c0a1b2c3d4e5f60718293","platform":"instagram","platform_user_id":"17841400008460056","username":"acme.studio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":{"status":"active","parked_reason":null,"next_read_at":"2026-09-15T02:00:00.000Z"},"capabilities":["media_stats","media_comments","media_demographics","account_insights","account_audience"],"metadata":{"segment":"creator"},"latest_as_of":"2026-09-14T00:00:00.000Z","connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/accounts/update-account-metadata"}}},"/instagram/accounts/{account_id}/audience":{"get":{"operationId":"instagram-accounts-audience","summary":"Audience geography, age and gender","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."},{"in":"query","name":"as_of","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"availability":{"type":"string","enum":["not_tracked","pending","unavailable","available"]},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"countries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"age":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"gender":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}}},"required":["account_id","username","availability","as_of","countries","age","gender"],"additionalProperties":false},"example":{"account_id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","availability":"available","as_of":"2026-09-14T00:00:00.000Z","countries":[{"bucket":"US","share_bps":3420}],"age":[{"bucket":"25-34","share_bps":4120}],"gender":[{"bucket":"F","share_bps":5480}]}}}},"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"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"},"example":{"error":{"code":"analytics_not_enabled","message":"Analytics is not enabled for this workspace.","request_id":"req_01K5A7Q3NB6D8F2H4V9T"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/accounts/audience-geography-age-and-gender"}}},"/instagram/accounts/{account_id}/insights":{"get":{"operationId":"instagram-accounts-insights","summary":"Daily account insights","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."},{"in":"query","name":"since","schema":{"type":"string"}},{"in":"query","name":"until","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"reach":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"followers_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["date","reach","followers_count","extra"],"additionalProperties":false}}},"required":["account_id","username","data"],"additionalProperties":false},"example":{"account_id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","data":[{"date":"2026-09-14","reach":138910,"followers_count":48790,"extra":{}}]}}}},"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"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"},"example":{"error":{"code":"analytics_not_enabled","message":"Analytics is not enabled for this workspace.","request_id":"req_01K5A7Q3NB6D8F2H4V9T"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/accounts/daily-account-insights"}}},"/instagram/connect-links":{"post":{"operationId":"instagram-connectLinks-create","summary":"Generate a login link","tags":["Connect"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_user_id":{"type":"string","minLength":1,"maxLength":255},"redirect_uri":{"type":"string","maxLength":2048,"format":"uri"},"force_reauth":{"default":false,"type":"boolean"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"platform":{"type":"string"},"external_user_id":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time"}},"required":["id","url","platform","external_user_id","expires_at"],"additionalProperties":false},"example":{"id":"cl_PxyaUm0eS4qfDix9WhuORA0tld0c0y87AWreyx-ASpI4t","url":"https://www.instagram.com/oauth/authorize?client_id=123456789012345","platform":"instagram","external_user_id":"customer_8f3a2c19","expires_at":"2026-09-14T11:00:00.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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/connect/generate-a-login-link"}}},"/instagram/connect-links/{connect_link_id}":{"get":{"operationId":"instagram-connectLinks-get","summary":"Read the outcome of a connect link","tags":["Connect"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"connect_link_id","schema":{"type":"string","description":"Connect link ID. Format: cl_ followed by 45 characters.","example":"cl_VQ6EAOKbQdSnFkRmVUQAAA0tld0c09tC987TgvH-IC_Mh"},"required":true,"description":"Connect link ID. Format: cl_ followed by 45 characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string"},"status":{"type":"string","description":"Known values: pending, expired, connected, already_linked, external_user_id_mismatch, needs_professional, missing_permissions."},"message":{"type":["string","null"]},"account":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},{"type":"null"}]},"expires_at":{"type":"string","format":"date-time"}},"required":["id","platform","status","message","account","expires_at"],"additionalProperties":false},"example":{"id":"cl_PxyaUm0eS4qfDix9WhuORA0tld0c0y87AWreyx-ASpI4t","platform":"instagram","status":"connected","message":null,"account":{"id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","external_user_id":"customer_8f3a2c19"},"expires_at":"2026-09-14T11:00:00.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/connect/read-the-outcome-of-a-connect-link"}}},"/instagram/submissions":{"post":{"operationId":"instagram-submissions-create","summary":"Put posts under tracking","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"account_id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}}},"required":["url"]}},"cadence_hours":{"type":"number","enum":[1,2,3,4,6,8,12],"description":"How often to read each media, in hours: 1, 2, 3, 4, 6, 8 or 12. A faster cadence costs fewer credits per read and more per day. The default is the project's cadence."},"start_at":{"description":"When tracking starts. The first read is at this time. The default is now.","type":"string","format":"date-time"},"end_at":{"description":"When tracking ends. It must be after start_at and in the future.","type":"string","format":"date-time"},"geo":{"description":"Collect audience data. Instagram and YouTube only. If you leave it out, the project's default applies. New projects default to on. On Instagram, geo reads the account's audience. Each read costs 4 more credits, and the account costs 1,500 credits per day. On YouTube, geo reads the media's own audience. Each read costs 4 more credits, with no account cost. We charge the 4 credits only while there is audience data to report.","type":"boolean"}},"required":["project_id","account_id","items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"estimate":{"type":"object","properties":{"credits_per_read":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"reads_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"credits_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"For one media. The daily geo account fee is not included."},"geo_account_credits_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Charged once per day for each Instagram account with a geo media. 0 when geo is off, and always 0 on YouTube."}},"required":["credits_per_read","reads_per_day","credits_per_day","geo_account_credits_per_day"],"additionalProperties":false,"description":"What one media with these settings costs."},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","description":"Known values: created, already_tracked, not_found, unsupported_url, platform_mismatch, not_owned (X and YouTube: another account published this URL), not_video (X: the URL has no video; YouTube: the URL is a live or upcoming broadcast)."},"submission":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["url","status","submission"],"additionalProperties":false}}},"required":["estimate","data"],"additionalProperties":false},"example":{"estimate":{"credits_per_read":15,"reads_per_day":6,"credits_per_day":90,"geo_account_credits_per_day":1500},"data":[{"url":"https://www.instagram.com/p/C9x4AbCdEfG/","status":"created","submission":{"id":"sub_4f9c0a1b2c3d4e5f60718293","platform":"instagram","url":"https://www.instagram.com/p/C9x4AbCdEfG/","platform_media_id":"18062712345678901","media_type":"short_video","account":{"id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":128450,"reach":96720,"likes":8140,"comments":326,"shares":1190,"saves":2480,"total_interactions":12136,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":"2026-10-10T14:25:43.000Z","geo":true,"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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":"Submission discovery is already running.","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":"The platform is rate-limiting this account.","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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/put-posts-under-tracking"}},"get":{"operationId":"instagram-submissions-list","summary":"List submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"project_id","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"account_id","schema":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"}},{"in":"query","name":"external_user_id","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"},"comments":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"username":{"type":["string","null"]},"commented_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"like_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","text","username","commented_at","like_count"],"additionalProperties":false}}},"required":["captured_at","items"],"additionalProperties":false},"demographics":{"type":"object","properties":{"basis":{"type":"string","description":"Whose audience this is. Known values: account (the connected account's audience during the media's first days, on Instagram), media (the media's own audience, on YouTube)."},"availability":{"type":"string","enum":["not_tracked","pending","unavailable","available"]},"window_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"countries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"views":{"description":"Views from this country. Present only when basis is media.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"age":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"gender":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}}},"required":["basis","availability","window_start","window_end","snapshot_count","countries","age","gender"],"additionalProperties":false}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at","comments"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"id":"sub_4f9c0a1b2c3d4e5f60718293","platform":"instagram","url":"https://www.instagram.com/p/C9x4AbCdEfG/","platform_media_id":"18062712345678901","media_type":"short_video","account":{"id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":128450,"reach":96720,"likes":8140,"comments":326,"shares":1190,"saves":2480,"total_interactions":12136,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":"2026-10-10T14:25:43.000Z","geo":true,"created_at":"2026-09-10T14:25:43.000Z","comments":{"captured_at":"2026-09-14T10:00:00.000Z","items":[]},"demographics":{"basis":"account","availability":"available","window_start":"2026-09-10T18:00:00.000Z","window_end":"2026-09-14T18:00:00.000Z","snapshot_count":5,"countries":[{"bucket":"US","share_bps":3420}],"age":[{"bucket":"25-34","share_bps":4120}],"gender":[{"bucket":"F","share_bps":5480}]}}],"next_cursor":null}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/list-submissions-in-a-project"}}},"/instagram/submissions/{submission_id}":{"get":{"operationId":"instagram-submissions-get","summary":"Get a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"},"demographics":{"type":"object","properties":{"basis":{"type":"string","description":"Whose audience this is. Known values: account (the connected account's audience during the media's first days, on Instagram), media (the media's own audience, on YouTube)."},"availability":{"type":"string","enum":["not_tracked","pending","unavailable","available"]},"window_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"countries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"views":{"description":"Views from this country. Present only when basis is media.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"age":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"gender":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}}},"required":["basis","availability","window_start","window_end","snapshot_count","countries","age","gender"],"additionalProperties":false}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_4f9c0a1b2c3d4e5f60718293","platform":"instagram","url":"https://www.instagram.com/p/C9x4AbCdEfG/","platform_media_id":"18062712345678901","media_type":"short_video","account":{"id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":128450,"reach":96720,"likes":8140,"comments":326,"shares":1190,"saves":2480,"total_interactions":12136,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":"2026-10-10T14:25:43.000Z","geo":true,"created_at":"2026-09-10T14:25:43.000Z","demographics":{"basis":"account","availability":"available","window_start":"2026-09-10T18:00:00.000Z","window_end":"2026-09-14T18:00:00.000Z","snapshot_count":5,"countries":[{"bucket":"US","share_bps":3420}],"age":[{"bucket":"25-34","share_bps":4120}],"gender":[{"bucket":"F","share_bps":5480}]}}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/get-a-submission"}},"patch":{"operationId":"instagram-submissions-update","summary":"Update a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},{"type":"null"}]},"cadence_hours":{"type":"number","enum":[1,2,3,4,6,8,12],"description":"How often to read each media, in hours: 1, 2, 3, 4, 6, 8 or 12. A faster cadence costs fewer credits per read and more per day. The default is the project's cadence."},"end_at":{"description":"A new end date, or null to remove it. It must be in the future.","anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"geo":{"description":"Set to true to turn geo on. Instagram and YouTube only. Set to false to turn it off before the first read. After the first read, false answers 409.","type":"boolean"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_4f9c0a1b2c3d4e5f60718293","platform":"instagram","url":"https://www.instagram.com/p/C9x4AbCdEfG/","platform_media_id":"18062712345678901","media_type":"short_video","account":{"id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":128450,"reach":96720,"likes":8140,"comments":326,"shares":1190,"saves":2480,"total_interactions":12136,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":"2026-10-10T14:25:43.000Z","geo":true,"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"}}}}},"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":"The request conflicts with the resource state.","request_id":"req_01K5A7R9HD4K7P2X6N8Q"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/update-a-submission"}}},"/instagram/submissions/pause":{"post":{"operationId":"instagram-submissions-pauseAll","summary":"Pause active submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"}},"required":["project_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"affected":{"type":"integer","minimum":0,"maximum":9007199254740991},"left_paused":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["affected"],"additionalProperties":false},"example":{"affected":24}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/pause-active-submissions-in-a-project"}}},"/instagram/submissions/resume":{"post":{"operationId":"instagram-submissions-resumeAll","summary":"Resume paused submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"}},"required":["project_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"affected":{"type":"integer","minimum":0,"maximum":9007199254740991},"left_paused":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["affected"],"additionalProperties":false},"example":{"affected":21,"left_paused":3}}}},"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/resume-paused-submissions-in-a-project"}}},"/instagram/submissions/{submission_id}/pause":{"post":{"operationId":"instagram-submissions-pause","summary":"Pause a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_4f9c0a1b2c3d4e5f60718293","platform":"instagram","url":"https://www.instagram.com/p/C9x4AbCdEfG/","platform_media_id":"18062712345678901","media_type":"short_video","account":{"id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","external_user_id":"customer_8f3a2c19"},"posted_at":"2026-09-10T14:22:00.000Z","status":"paused","next_read_at":null,"unavailable_reason":null,"parked_reason":null,"latest":{"captured_at":"2026-09-14T10:00:00.000Z","views":128450,"reach":96720,"likes":8140,"comments":326,"shares":1190,"saves":2480,"total_interactions":12136,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":"2026-10-10T14:25:43.000Z","geo":true,"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"}}}}},"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":"The request conflicts with the resource state.","request_id":"req_01K5A7R9HD4K7P2X6N8Q"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/pause-a-submission"}}},"/instagram/submissions/{submission_id}/resume":{"post":{"operationId":"instagram-submissions-resume","summary":"Resume a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_4f9c0a1b2c3d4e5f60718293","platform":"instagram","url":"https://www.instagram.com/p/C9x4AbCdEfG/","platform_media_id":"18062712345678901","media_type":"short_video","account":{"id":"acct_3f9c0a1b2c3d4e5f60718293","username":"acme.studio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":128450,"reach":96720,"likes":8140,"comments":326,"shares":1190,"saves":2480,"total_interactions":12136,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":"2026-10-10T14:25:43.000Z","geo":true,"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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":"Reconnect this account before resuming.","request_id":"req_01K5A7T8QK3F6H9D2W5Z"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/resume-a-submission"}}},"/instagram/submissions/{submission_id}/stats":{"get":{"operationId":"instagram-submissions-stats","summary":"Submission metric history","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."},{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"captured_at":{"type":"string","format":"date-time"},"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"}]},"avg_watch_time_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"total_watch_time_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","avg_watch_time_ms","total_watch_time_ms","extra"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"captured_at":"2026-09-14T10:00:00.000Z","views":128450,"reach":96720,"likes":8140,"comments":326,"shares":1190,"saves":2480,"total_interactions":12136,"extra":{},"avg_watch_time_ms":18400,"total_watch_time_ms":2363480000}],"next_cursor":null}}}},"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"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"},"example":{"error":{"code":"analytics_not_enabled","message":"Analytics is not enabled for this workspace.","request_id":"req_01K5A7Q3NB6D8F2H4V9T"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/submission-metric-history"}}},"/instagram/submissions/{submission_id}/bot-score":{"get":{"operationId":"instagram-submissions-botScore","summary":"Submission bot score","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"scored":{"type":"boolean","description":"False until a read reports views. All score fields are then null."},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"The time of the newest read. Null before the first read."},"trust_score":{"anyOf":[{"type":"integer","minimum":1,"maximum":100},{"type":"null"}],"description":"1 to 100. Higher is more organic. It is independent of bot_flagged."},"bot_flagged":{"description":"True when any one check lands in an extreme band.","type":["boolean","null"]},"views_at_score":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"snapshot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The reads with views that the score uses."},"signals":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string","description":"The check. Known values: engagement_ratio, like_ratio, comment_ratio, share_ratio, save_ratio, uniqueness_ratio, view_curve, velocity_ratio, spike_engagement, plateaus, trend_reversal, engagement_timing."},"band":{"type":"string","enum":["very_low","low","expected","high","very_high"],"description":"Where the measured value falls. very_low and very_high flag the submission."},"evaluated":{"type":"boolean","description":"False when there is not enough data for this check. An unevaluated check counts as expected."},"flagged":{"type":"boolean"},"value_bps":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"The measured value in basis points. 10000 is 1. Null when the check has no single value."},"detail":{"type":["string","null"]}},"required":["metric","band","evaluated","flagged","value_bps","detail"],"additionalProperties":false}}},"required":["scored","as_of","trust_score","bot_flagged","views_at_score","snapshot_count","signals"],"additionalProperties":false},"example":{"scored":true,"as_of":"2026-09-14T10:00:00.000Z","trust_score":100,"bot_flagged":false,"views_at_score":128450,"snapshot_count":7,"signals":[{"metric":"engagement_ratio","band":"expected","evaluated":true,"flagged":false,"value_bps":945,"detail":null},{"metric":"like_ratio","band":"expected","evaluated":true,"flagged":false,"value_bps":634,"detail":null},{"metric":"comment_ratio","band":"expected","evaluated":true,"flagged":false,"value_bps":25,"detail":null},{"metric":"share_ratio","band":"expected","evaluated":true,"flagged":false,"value_bps":93,"detail":null},{"metric":"save_ratio","band":"expected","evaluated":true,"flagged":false,"value_bps":193,"detail":null},{"metric":"uniqueness_ratio","band":"expected","evaluated":true,"flagged":false,"value_bps":7530,"detail":null},{"metric":"view_curve","band":"expected","evaluated":true,"flagged":false,"value_bps":null,"detail":null},{"metric":"velocity_ratio","band":"expected","evaluated":true,"flagged":false,"value_bps":13285,"detail":"Peak 6.9K/h, median 5.2K/h"},{"metric":"spike_engagement","band":"expected","evaluated":true,"flagged":false,"value_bps":945,"detail":"5.0K interactions / 53.1K views"},{"metric":"plateaus","band":"expected","evaluated":true,"flagged":false,"value_bps":0,"detail":"No stalls before new growth"},{"metric":"trend_reversal","band":"expected","evaluated":true,"flagged":false,"value_bps":0,"detail":"No growth restarts after a decline"},{"metric":"engagement_timing","band":"expected","evaluated":true,"flagged":false,"value_bps":3721,"detail":"37% of likes (2.8K/7.5K) while views were slow"}]}}}},"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"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"},"example":{"error":{"code":"analytics_not_enabled","message":"Analytics is not enabled for this workspace.","request_id":"req_01K5A7Q3NB6D8F2H4V9T"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/instagram/submissions/submission-bot-score"}}},"/x/accounts":{"get":{"operationId":"x-accounts-list","summary":"List connected social accounts","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"external_user_id","schema":{"type":"string"}},{"in":"query","name":"username","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","platform":"x","platform_user_id":"1456789012345678901","username":"acmestudio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":null,"capabilities":["media_stats"],"metadata":{"segment":"creator"},"latest_as_of":null,"connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.000Z"}],"next_cursor":null}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/accounts/list-connected-social-accounts"}}},"/x/accounts/{account_id}":{"get":{"operationId":"x-accounts-get","summary":"Get an account","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false},"example":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","platform":"x","platform_user_id":"1456789012345678901","username":"acmestudio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":null,"capabilities":["media_stats"],"metadata":{"segment":"creator"},"latest_as_of":null,"connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/accounts/get-an-account"}},"patch":{"operationId":"x-accounts-update","summary":"Update account metadata","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},{"type":"null"}]}},"required":["metadata"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false},"example":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","platform":"x","platform_user_id":"1456789012345678901","username":"acmestudio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":null,"capabilities":["media_stats"],"metadata":{"segment":"creator"},"latest_as_of":null,"connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/accounts/update-account-metadata"}}},"/x/connect-links":{"post":{"operationId":"x-connectLinks-create","summary":"Generate a login link","tags":["Connect"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_user_id":{"type":"string","minLength":1,"maxLength":255},"redirect_uri":{"type":"string","maxLength":2048,"format":"uri"},"force_reauth":{"default":false,"type":"boolean"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"platform":{"type":"string"},"external_user_id":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time"}},"required":["id","url","platform","external_user_id","expires_at"],"additionalProperties":false},"example":{"id":"cl_mk0scT5bT4Chxn0umw86WA0tld0c0tF1l_FnR9ylg5w49","url":"https://x.com/i/oauth2/authorize?response_type=code&client_id=Y2xpZW50LWlk","platform":"x","external_user_id":"customer_8f3a2c19","expires_at":"2026-09-14T11:00:00.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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/connect/generate-a-login-link"}}},"/x/connect-links/{connect_link_id}":{"get":{"operationId":"x-connectLinks-get","summary":"Read the outcome of a connect link","tags":["Connect"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"connect_link_id","schema":{"type":"string","description":"Connect link ID. Format: cl_ followed by 45 characters.","example":"cl_VQ6EAOKbQdSnFkRmVUQAAA0tld0c09tC987TgvH-IC_Mh"},"required":true,"description":"Connect link ID. Format: cl_ followed by 45 characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string"},"status":{"type":"string","description":"Known values: pending, expired, connected, already_linked, external_user_id_mismatch, needs_professional, missing_permissions."},"message":{"type":["string","null"]},"account":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},{"type":"null"}]},"expires_at":{"type":"string","format":"date-time"}},"required":["id","platform","status","message","account","expires_at"],"additionalProperties":false},"example":{"id":"cl_mk0scT5bT4Chxn0umw86WA0tld0c0tF1l_FnR9ylg5w49","platform":"x","status":"connected","message":null,"account":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"expires_at":"2026-09-14T11:00:00.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/connect/read-the-outcome-of-a-connect-link"}}},"/x/submissions":{"post":{"operationId":"x-submissions-create","summary":"Put posts under tracking","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"account_id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}}},"required":["url"]}},"cadence_hours":{"type":"number","enum":[1,2,3,4,6,8,12],"description":"How often to read each media, in hours: 1, 2, 3, 4, 6, 8 or 12. A faster cadence costs fewer credits per read and more per day. The default is the project's cadence."},"start_at":{"description":"When tracking starts. The first read is at this time. The default is now.","type":"string","format":"date-time"},"end_at":{"description":"When tracking ends. It must be after start_at and in the future.","type":"string","format":"date-time"},"geo":{"description":"Collect audience data. Instagram and YouTube only. If you leave it out, the project's default applies. New projects default to on. On Instagram, geo reads the account's audience. Each read costs 4 more credits, and the account costs 1,500 credits per day. On YouTube, geo reads the media's own audience. Each read costs 4 more credits, with no account cost. We charge the 4 credits only while there is audience data to report.","type":"boolean"}},"required":["project_id","account_id","items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"estimate":{"type":"object","properties":{"credits_per_read":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"reads_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"credits_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"For one media. The daily geo account fee is not included."},"geo_account_credits_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Charged once per day for each Instagram account with a geo media. 0 when geo is off, and always 0 on YouTube."}},"required":["credits_per_read","reads_per_day","credits_per_day","geo_account_credits_per_day"],"additionalProperties":false,"description":"What one media with these settings costs."},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","description":"Known values: created, already_tracked, not_found, unsupported_url, platform_mismatch, not_owned (X and YouTube: another account published this URL), not_video (X: the URL has no video; YouTube: the URL is a live or upcoming broadcast)."},"submission":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["url","status","submission"],"additionalProperties":false}}},"required":["estimate","data"],"additionalProperties":false},"example":{"estimate":{"credits_per_read":11,"reads_per_day":6,"credits_per_day":66,"geo_account_credits_per_day":0},"data":[{"url":"https://x.com/acmestudio/status/1834567890123456789","status":"created","submission":{"id":"sub_8c3f5a7b9d1e2f4a6b8c0d2e","platform":"x","url":"https://x.com/i/status/1834567890123456789","platform_media_id":"1834567890123456789","media_type":"video","account":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":214300,"reach":null,"likes":5920,"comments":412,"shares":1036,"saves":880,"total_interactions":null,"extra":{"quotes":97}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"created_at":"2026-09-10T14:25:43.000Z"}},{"url":"https://x.com/someone/status/1834567890000000001","status":"not_owned","submission":null}]}}}},"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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":"This X account is not connected. Send the end user through a new connect link.","request_id":"req_01K5A7V2RB7N4K8C3X6T"}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.TOO_MANY_REQUESTS"},"example":{"error":{"code":"rate_limited","message":"Too many X URLs were checked at once. Try again in a few minutes.","request_id":"req_01K5A7V6JD2Q9F5M8W1H"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/put-posts-under-tracking"}},"get":{"operationId":"x-submissions-list","summary":"List submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"project_id","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"account_id","schema":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"}},{"in":"query","name":"external_user_id","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"},"comments":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"username":{"type":["string","null"]},"commented_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"like_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","text","username","commented_at","like_count"],"additionalProperties":false}}},"required":["captured_at","items"],"additionalProperties":false},"demographics":{"type":"object","properties":{"basis":{"type":"string","description":"Whose audience this is. Known values: account (the connected account's audience during the media's first days, on Instagram), media (the media's own audience, on YouTube)."},"availability":{"type":"string","enum":["not_tracked","pending","unavailable","available"]},"window_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"countries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"views":{"description":"Views from this country. Present only when basis is media.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"age":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"gender":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}}},"required":["basis","availability","window_start","window_end","snapshot_count","countries","age","gender"],"additionalProperties":false}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at","comments"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"id":"sub_8c3f5a7b9d1e2f4a6b8c0d2e","platform":"x","url":"https://x.com/i/status/1834567890123456789","platform_media_id":"1834567890123456789","media_type":"video","account":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":214300,"reach":null,"likes":5920,"comments":412,"shares":1036,"saves":880,"total_interactions":null,"extra":{"quotes":97}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"created_at":"2026-09-10T14:25:43.000Z","comments":{"captured_at":null,"items":[]}}],"next_cursor":null}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/list-submissions-in-a-project"}}},"/x/submissions/{submission_id}":{"get":{"operationId":"x-submissions-get","summary":"Get a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"},"demographics":{"type":"object","properties":{"basis":{"type":"string","description":"Whose audience this is. Known values: account (the connected account's audience during the media's first days, on Instagram), media (the media's own audience, on YouTube)."},"availability":{"type":"string","enum":["not_tracked","pending","unavailable","available"]},"window_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"countries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"views":{"description":"Views from this country. Present only when basis is media.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"age":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"gender":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}}},"required":["basis","availability","window_start","window_end","snapshot_count","countries","age","gender"],"additionalProperties":false}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_8c3f5a7b9d1e2f4a6b8c0d2e","platform":"x","url":"https://x.com/i/status/1834567890123456789","platform_media_id":"1834567890123456789","media_type":"video","account":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":214300,"reach":null,"likes":5920,"comments":412,"shares":1036,"saves":880,"total_interactions":null,"extra":{"quotes":97}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/get-a-submission"}},"patch":{"operationId":"x-submissions-update","summary":"Update a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},{"type":"null"}]},"cadence_hours":{"type":"number","enum":[1,2,3,4,6,8,12],"description":"How often to read each media, in hours: 1, 2, 3, 4, 6, 8 or 12. A faster cadence costs fewer credits per read and more per day. The default is the project's cadence."},"end_at":{"description":"A new end date, or null to remove it. It must be in the future.","anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"geo":{"description":"Set to true to turn geo on. Instagram and YouTube only. Set to false to turn it off before the first read. After the first read, false answers 409.","type":"boolean"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_8c3f5a7b9d1e2f4a6b8c0d2e","platform":"x","url":"https://x.com/i/status/1834567890123456789","platform_media_id":"1834567890123456789","media_type":"video","account":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":214300,"reach":null,"likes":5920,"comments":412,"shares":1036,"saves":880,"total_interactions":null,"extra":{"quotes":97}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"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"}}}}},"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":"The request conflicts with the resource state.","request_id":"req_01K5A7R9HD4K7P2X6N8Q"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/update-a-submission"}}},"/x/submissions/pause":{"post":{"operationId":"x-submissions-pauseAll","summary":"Pause active submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"}},"required":["project_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"affected":{"type":"integer","minimum":0,"maximum":9007199254740991},"left_paused":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["affected"],"additionalProperties":false},"example":{"affected":24}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/pause-active-submissions-in-a-project"}}},"/x/submissions/resume":{"post":{"operationId":"x-submissions-resumeAll","summary":"Resume paused submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"}},"required":["project_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"affected":{"type":"integer","minimum":0,"maximum":9007199254740991},"left_paused":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["affected"],"additionalProperties":false},"example":{"affected":21,"left_paused":3}}}},"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/resume-paused-submissions-in-a-project"}}},"/x/submissions/{submission_id}/pause":{"post":{"operationId":"x-submissions-pause","summary":"Pause a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_8c3f5a7b9d1e2f4a6b8c0d2e","platform":"x","url":"https://x.com/i/status/1834567890123456789","platform_media_id":"1834567890123456789","media_type":"video","account":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"posted_at":"2026-09-10T14:22:00.000Z","status":"paused","next_read_at":null,"unavailable_reason":null,"parked_reason":null,"latest":{"captured_at":"2026-09-14T10:00:00.000Z","views":214300,"reach":null,"likes":5920,"comments":412,"shares":1036,"saves":880,"total_interactions":null,"extra":{"quotes":97}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"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"}}}}},"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":"The request conflicts with the resource state.","request_id":"req_01K5A7R9HD4K7P2X6N8Q"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/pause-a-submission"}}},"/x/submissions/{submission_id}/resume":{"post":{"operationId":"x-submissions-resume","summary":"Resume a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_8c3f5a7b9d1e2f4a6b8c0d2e","platform":"x","url":"https://x.com/i/status/1834567890123456789","platform_media_id":"1834567890123456789","media_type":"video","account":{"id":"acct_7b2e4d6f8a0c1e3a5c7e9b1d","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":214300,"reach":null,"likes":5920,"comments":412,"shares":1036,"saves":880,"total_interactions":null,"extra":{"quotes":97}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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":"Reconnect this account before resuming.","request_id":"req_01K5A7T8QK3F6H9D2W5Z"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/resume-a-submission"}}},"/x/submissions/{submission_id}/stats":{"get":{"operationId":"x-submissions-stats","summary":"Submission metric history","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."},{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"captured_at":{"type":"string","format":"date-time"},"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"}]},"avg_watch_time_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"total_watch_time_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","avg_watch_time_ms","total_watch_time_ms","extra"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"captured_at":"2026-09-14T10:00:00.000Z","views":214300,"reach":null,"likes":5920,"comments":412,"shares":1036,"saves":880,"total_interactions":null,"extra":{"quotes":97},"avg_watch_time_ms":null,"total_watch_time_ms":null}],"next_cursor":null}}}},"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"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"},"example":{"error":{"code":"analytics_not_enabled","message":"Analytics is not enabled for this workspace.","request_id":"req_01K5A7Q3NB6D8F2H4V9T"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/x/submissions/submission-metric-history"}}},"/youtube/accounts":{"get":{"operationId":"youtube-accounts-list","summary":"List connected social accounts","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"external_user_id","schema":{"type":"string"}},{"in":"query","name":"username","schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","platform":"youtube","platform_user_id":"UC4R8DWoMoI7CAwX8_LjQHig","username":"acmestudio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":null,"capabilities":["media_stats","media_demographics"],"metadata":{"segment":"creator"},"latest_as_of":null,"connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.000Z"}],"next_cursor":null}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/accounts/list-connected-social-accounts"}}},"/youtube/accounts/{account_id}":{"get":{"operationId":"youtube-accounts-get","summary":"Get an account","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false},"example":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","platform":"youtube","platform_user_id":"UC4R8DWoMoI7CAwX8_LjQHig","username":"acmestudio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":null,"capabilities":["media_stats","media_demographics"],"metadata":{"segment":"creator"},"latest_as_of":null,"connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/accounts/get-an-account"}},"patch":{"operationId":"youtube-accounts-update","summary":"Update account metadata","tags":["Accounts"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"account_id","schema":{"type":"string","description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters.","example":"acct_2b4b06ac31e358b242694941"},"required":true,"description":"Account ID. Format: acct_ followed by 24 lowercase hexadecimal characters."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},{"type":"null"}]}},"required":["metadata"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"platform_user_id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"},"connection":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","needs_reauth","revoked"]},"reason":{"description":"Why the end user must connect again. Null unless status is needs_reauth. Known values: token_invalid (the sign-in expired or was revoked), insights_permission_missing (the end user did not allow access to insights), account_not_professional (the Instagram account was switched to a personal account).","type":["string","null"]}},"required":["status","reason"],"additionalProperties":false},{"type":"null"}]},"tracking":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["active","parked","stopped"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["status","parked_reason","next_read_at"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"type":"array","items":{"type":"string"},"description":"Data this kind of connection can read. It does not prove that data exists for this account: check the data's own captured_at. Known values: media_stats, media_comments, media_demographics, account_insights, account_audience."},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"latest_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"connected_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","platform_user_id","username","external_user_id","connection","tracking","capabilities","metadata","connected_at","created_at"],"additionalProperties":false},"example":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","platform":"youtube","platform_user_id":"UC4R8DWoMoI7CAwX8_LjQHig","username":"acmestudio","external_user_id":"customer_8f3a2c19","connection":{"status":"active","reason":null},"tracking":null,"capabilities":["media_stats","media_demographics"],"metadata":{"segment":"creator"},"latest_as_of":null,"connected_at":"2026-09-10T14:22:18.000Z","created_at":"2026-09-10T14:22:18.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/accounts/update-account-metadata"}}},"/youtube/connect-links":{"post":{"operationId":"youtube-connectLinks-create","summary":"Generate a login link","tags":["Connect"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_user_id":{"type":"string","minLength":1,"maxLength":255},"redirect_uri":{"type":"string","maxLength":2048,"format":"uri"},"force_reauth":{"default":false,"type":"boolean"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"platform":{"type":"string"},"external_user_id":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time"}},"required":["id","url","platform","external_user_id","expires_at"],"additionalProperties":false},"example":{"id":"cl_Rk3vYq9mQ0a1Lw7ZsT2xHA0tld0c0pQ4m_JnV8ckd3a71","url":"https://accounts.google.com/o/oauth2/v2/auth?response_type=code&client_id=Y2xpZW50LWlk","platform":"youtube","external_user_id":"customer_8f3a2c19","expires_at":"2026-09-14T11:00:00.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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/connect/generate-a-login-link"}}},"/youtube/connect-links/{connect_link_id}":{"get":{"operationId":"youtube-connectLinks-get","summary":"Read the outcome of a connect link","tags":["Connect"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"connect_link_id","schema":{"type":"string","description":"Connect link ID. Format: cl_ followed by 45 characters.","example":"cl_VQ6EAOKbQdSnFkRmVUQAAA0tld0c09tC987TgvH-IC_Mh"},"required":true,"description":"Connect link ID. Format: cl_ followed by 45 characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string"},"status":{"type":"string","description":"Known values: pending, expired, connected, already_linked, external_user_id_mismatch, needs_professional, missing_permissions."},"message":{"type":["string","null"]},"account":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},{"type":"null"}]},"expires_at":{"type":"string","format":"date-time"}},"required":["id","platform","status","message","account","expires_at"],"additionalProperties":false},"example":{"id":"cl_Rk3vYq9mQ0a1Lw7ZsT2xHA0tld0c0pQ4m_JnV8ckd3a71","platform":"youtube","status":"connected","message":null,"account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"expires_at":"2026-09-14T11:00:00.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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/connect/read-the-outcome-of-a-connect-link"}}},"/youtube/submissions":{"post":{"operationId":"youtube-submissions-create","summary":"Put posts under tracking","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"account_id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}}},"required":["url"]}},"cadence_hours":{"type":"number","enum":[1,2,3,4,6,8,12],"description":"How often to read each media, in hours: 1, 2, 3, 4, 6, 8 or 12. A faster cadence costs fewer credits per read and more per day. The default is the project's cadence."},"start_at":{"description":"When tracking starts. The first read is at this time. The default is now.","type":"string","format":"date-time"},"end_at":{"description":"When tracking ends. It must be after start_at and in the future.","type":"string","format":"date-time"},"geo":{"description":"Collect audience data. Instagram and YouTube only. If you leave it out, the project's default applies. New projects default to on. On Instagram, geo reads the account's audience. Each read costs 4 more credits, and the account costs 1,500 credits per day. On YouTube, geo reads the media's own audience. Each read costs 4 more credits, with no account cost. We charge the 4 credits only while there is audience data to report.","type":"boolean"}},"required":["project_id","account_id","items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"estimate":{"type":"object","properties":{"credits_per_read":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"reads_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"credits_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"For one media. The daily geo account fee is not included."},"geo_account_credits_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Charged once per day for each Instagram account with a geo media. 0 when geo is off, and always 0 on YouTube."}},"required":["credits_per_read","reads_per_day","credits_per_day","geo_account_credits_per_day"],"additionalProperties":false,"description":"What one media with these settings costs."},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","description":"Known values: created, already_tracked, not_found, unsupported_url, platform_mismatch, not_owned (X and YouTube: another account published this URL), not_video (X: the URL has no video; YouTube: the URL is a live or upcoming broadcast)."},"submission":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["url","status","submission"],"additionalProperties":false}}},"required":["estimate","data"],"additionalProperties":false},"example":{"estimate":{"credits_per_read":11,"reads_per_day":6,"credits_per_day":66,"geo_account_credits_per_day":0},"data":[{"url":"https://youtube.com/shorts/aqz-KE-bpKQ?feature=share","status":"created","submission":{"id":"sub_5e7a9c1b3d5f7a9c1e3b5d7f","platform":"youtube","url":"https://www.youtube.com/watch?v=aqz-KE-bpKQ","platform_media_id":"aqz-KE-bpKQ","media_type":"short_video","account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"created_at":"2026-09-10T14:25:43.000Z"}},{"url":"https://www.youtube.com/watch?v=M7lc1UVf-VE","status":"created","submission":{"id":"sub_6f8b0d2c4e6a8b0d2f4c6e8a","platform":"youtube","url":"https://www.youtube.com/watch?v=M7lc1UVf-VE","platform_media_id":"M7lc1UVf-VE","media_type":"video","account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"created_at":"2026-09-10T14:25:43.000Z"}},{"url":"https://www.youtube.com/live/jNQXAC9IVRw","status":"not_video","submission":null}]}}}},"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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":"This YouTube account is not connected. Send the end user through a new connect link.","request_id":"req_01K5A7W3PC8M5J2D7Y4R"}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.TOO_MANY_REQUESTS"},"example":{"error":{"code":"rate_limited","message":"YouTube URLs cannot be checked right now. Try again later.","request_id":"req_01K5A7W8KF3T6N9B2Q5Z"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/put-posts-under-tracking"}},"get":{"operationId":"youtube-submissions-list","summary":"List submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"project_id","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"account_id","schema":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"}},{"in":"query","name":"external_user_id","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"},"comments":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"username":{"type":["string","null"]},"commented_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"like_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","text","username","commented_at","like_count"],"additionalProperties":false}}},"required":["captured_at","items"],"additionalProperties":false},"demographics":{"type":"object","properties":{"basis":{"type":"string","description":"Whose audience this is. Known values: account (the connected account's audience during the media's first days, on Instagram), media (the media's own audience, on YouTube)."},"availability":{"type":"string","enum":["not_tracked","pending","unavailable","available"]},"window_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"countries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"views":{"description":"Views from this country. Present only when basis is media.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"age":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"gender":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}}},"required":["basis","availability","window_start","window_end","snapshot_count","countries","age","gender"],"additionalProperties":false}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at","comments"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"id":"sub_5e7a9c1b3d5f7a9c1e3b5d7f","platform":"youtube","url":"https://www.youtube.com/watch?v=aqz-KE-bpKQ","platform_media_id":"aqz-KE-bpKQ","media_type":"short_video","account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":true,"created_at":"2026-09-10T14:25:43.000Z","comments":{"captured_at":null,"items":[]},"demographics":{"basis":"media","availability":"available","window_start":"2026-09-10T00:00:00.000Z","window_end":"2026-09-14T06:00:00.000Z","snapshot_count":1,"countries":[{"bucket":"US","share_bps":4210,"views":162640},{"bucket":"GB","share_bps":1180,"views":45590}],"age":[{"bucket":"age18-24","share_bps":3870},{"bucket":"age25-34","share_bps":3140}],"gender":[{"bucket":"male","share_bps":6020},{"bucket":"female","share_bps":3940}]}}],"next_cursor":null}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/list-submissions-in-a-project"}}},"/youtube/submissions/{submission_id}":{"get":{"operationId":"youtube-submissions-get","summary":"Get a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"},"demographics":{"type":"object","properties":{"basis":{"type":"string","description":"Whose audience this is. Known values: account (the connected account's audience during the media's first days, on Instagram), media (the media's own audience, on YouTube)."},"availability":{"type":"string","enum":["not_tracked","pending","unavailable","available"]},"window_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"countries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"views":{"description":"Views from this country. Present only when basis is media.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"age":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}},"gender":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket","share_bps"],"additionalProperties":false}}},"required":["basis","availability","window_start","window_end","snapshot_count","countries","age","gender"],"additionalProperties":false}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_5e7a9c1b3d5f7a9c1e3b5d7f","platform":"youtube","url":"https://www.youtube.com/watch?v=aqz-KE-bpKQ","platform_media_id":"aqz-KE-bpKQ","media_type":"short_video","account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":true,"created_at":"2026-09-10T14:25:43.000Z","demographics":{"basis":"media","availability":"available","window_start":"2026-09-10T00:00:00.000Z","window_end":"2026-09-14T06:00:00.000Z","snapshot_count":1,"countries":[{"bucket":"US","share_bps":4210,"views":162640},{"bucket":"GB","share_bps":1180,"views":45590}],"age":[{"bucket":"age18-24","share_bps":3870},{"bucket":"age25-34","share_bps":3140}],"gender":[{"bucket":"male","share_bps":6020},{"bucket":"female","share_bps":3940}]}}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/get-a-submission"}},"patch":{"operationId":"youtube-submissions-update","summary":"Update a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},{"type":"null"}]},"cadence_hours":{"type":"number","enum":[1,2,3,4,6,8,12],"description":"How often to read each media, in hours: 1, 2, 3, 4, 6, 8 or 12. A faster cadence costs fewer credits per read and more per day. The default is the project's cadence."},"end_at":{"description":"A new end date, or null to remove it. It must be in the future.","anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"geo":{"description":"Set to true to turn geo on. Instagram and YouTube only. Set to false to turn it off before the first read. After the first read, false answers 409.","type":"boolean"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_5e7a9c1b3d5f7a9c1e3b5d7f","platform":"youtube","url":"https://www.youtube.com/watch?v=aqz-KE-bpKQ","platform_media_id":"aqz-KE-bpKQ","media_type":"short_video","account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"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"}}}}},"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":"The request conflicts with the resource state.","request_id":"req_01K5A7R9HD4K7P2X6N8Q"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/update-a-submission"}}},"/youtube/submissions/pause":{"post":{"operationId":"youtube-submissions-pauseAll","summary":"Pause active submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"}},"required":["project_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"affected":{"type":"integer","minimum":0,"maximum":9007199254740991},"left_paused":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["affected"],"additionalProperties":false},"example":{"affected":24}}}},"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"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/pause-active-submissions-in-a-project"}}},"/youtube/submissions/resume":{"post":{"operationId":"youtube-submissions-resumeAll","summary":"Resume paused submissions in a project","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"}},"required":["project_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"affected":{"type":"integer","minimum":0,"maximum":9007199254740991},"left_paused":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["affected"],"additionalProperties":false},"example":{"affected":21,"left_paused":3}}}},"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/resume-paused-submissions-in-a-project"}}},"/youtube/submissions/{submission_id}/pause":{"post":{"operationId":"youtube-submissions-pause","summary":"Pause a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_5e7a9c1b3d5f7a9c1e3b5d7f","platform":"youtube","url":"https://www.youtube.com/watch?v=aqz-KE-bpKQ","platform_media_id":"aqz-KE-bpKQ","media_type":"short_video","account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"posted_at":"2026-09-10T14:22:00.000Z","status":"paused","next_read_at":null,"unavailable_reason":null,"parked_reason":null,"latest":{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"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"}}}}},"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":"The request conflicts with the resource state.","request_id":"req_01K5A7R9HD4K7P2X6N8Q"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/pause-a-submission"}}},"/youtube/submissions/{submission_id}/resume":{"post":{"operationId":"youtube-submissions-resume","summary":"Resume a submission","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^sub_[0-9a-f]{24}$"},"platform":{"type":"string","description":"Platform identifier. Known values: instagram, x, youtube."},"url":{"type":"string","format":"uri"},"platform_media_id":{"type":"string"},"media_type":{"description":"Known values: short_video, video, image, carousel, text. On YouTube, short_video means 180 seconds or less and video means longer than 180 seconds.","type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acct_[0-9a-f]{24}$"},"username":{"type":"string"},"external_user_id":{"type":"string"}},"required":["id","username","external_user_id"],"additionalProperties":false},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status":{"type":"string","enum":["active","paused","unavailable","parked","stopped"]},"next_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"unavailable_reason":{"description":"Known values: post_not_found, posted_before_professional, token_invalid, no_linked_account, connection_removed.","type":["string","null"]},"parked_reason":{"description":"Known values: token_invalid, insights_permission_missing, account_not_professional, read_failed.","type":["string","null"]},"latest":{"type":"object","properties":{"captured_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"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"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","extra"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"cadence_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How often this media is read, in hours."},"start_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking starts. Null means it started at create."},"end_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking ends. The media becomes stopped at this time. Null means no end date."},"geo":{"type":"boolean","description":"True when audience data is collected for this media: its account's audience on Instagram, the media's own audience on YouTube. Instagram and YouTube only."},"created_at":{"type":"string","format":"date-time"}},"required":["id","platform","url","platform_media_id","media_type","account","posted_at","status","next_read_at","unavailable_reason","parked_reason","metadata","cadence_hours","start_at","end_at","geo","created_at"],"additionalProperties":false},"example":{"id":"sub_5e7a9c1b3d5f7a9c1e3b5d7f","platform":"youtube","url":"https://www.youtube.com/watch?v=aqz-KE-bpKQ","platform_media_id":"aqz-KE-bpKQ","media_type":"short_video","account":{"id":"acct_3d5f7a9b1c2e4f6a8b0c1d3e","username":"acmestudio","external_user_id":"customer_8f3a2c19"},"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":{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{}},"metadata":{"campaign":"fall"},"cadence_hours":4,"start_at":null,"end_at":null,"geo":false,"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":"insufficient_credits","message":"This workspace has no credits left. Buy credits on the Billing page to resume tracking.","balance":0,"required":1,"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":"Reconnect this account before resuming.","request_id":"req_01K5A7T8QK3F6H9D2W5Z"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/resume-a-submission"}}},"/youtube/submissions/{submission_id}/stats":{"get":{"operationId":"youtube-submissions-stats","summary":"Submission metric history","tags":["Submissions"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"submission_id","schema":{"type":"string","description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters.","example":"sub_0899bdcb659c102e360005ec"},"required":true,"description":"Submission ID. Format: sub_ followed by 24 lowercase hexadecimal characters."},{"in":"query","name":"limit","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"captured_at":{"type":"string","format":"date-time"},"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"}]},"avg_watch_time_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"total_watch_time_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"extra":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["captured_at","views","reach","likes","comments","shares","saves","total_interactions","avg_watch_time_ms","total_watch_time_ms","extra"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"],"additionalProperties":false},"example":{"data":[{"captured_at":"2026-09-14T10:00:00.000Z","views":386400,"reach":null,"likes":12870,"comments":341,"shares":null,"saves":null,"total_interactions":null,"extra":{},"avg_watch_time_ms":null,"total_watch_time_ms":null}],"next_cursor":null}}}},"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"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"},"example":{"error":{"code":"analytics_not_enabled","message":"Analytics is not enabled for this workspace.","request_id":"req_01K5A7Q3NB6D8F2H4V9T"}}}}},"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"}}}}},"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"}}}}}},"x-mint":{"href":"/api-reference/youtube/submissions/submission-metric-history"}}},"/projects":{"get":{"operationId":"projects-list","summary":"List projects in this workspace","tags":["Projects"],"security":[{"Authorization":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^prj_[0-9a-f]{24}$"},"name":{"type":"string"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"archived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"}},"required":["id","name","metadata","archived_at","created_at"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"id":"prj_5f9c0a1b2c3d4e5f60718293","name":"Fall campaign","metadata":{"region":"global"},"archived_at":null,"created_at":"2026-09-10T14:20:00.000Z"}]}}}},"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"}}}}},"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"}}}}}}}},"/projects/{project_id}":{"patch":{"operationId":"projects-update","summary":"Update project metadata","tags":["Projects"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"project_id","schema":{"type":"string","description":"Project ID. Format: prj_ followed by 24 lowercase hexadecimal characters.","example":"prj_180b06ac31e358b242694941"},"required":true,"description":"Project ID. Format: prj_ followed by 24 lowercase hexadecimal characters."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},{"type":"null"}]}},"required":["metadata"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^prj_[0-9a-f]{24}$"},"name":{"type":"string"},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500}},"archived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"}},"required":["id","name","metadata","archived_at","created_at"],"additionalProperties":false},"example":{"id":"prj_5f9c0a1b2c3d4e5f60718293","name":"Fall campaign","metadata":{"region":"global"},"archived_at":null,"created_at":"2026-09-10T14:20:00.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"}}}}},"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"}}}}},"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"}}}}}}}},"/credits":{"get":{"operationId":"credits-get","summary":"Get the credit balance","tags":["Credits"],"security":[{"Authorization":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits the workspace holds now. Can be a little below 0: a read that already happened is never refused."},"tracking_paused":{"type":"boolean","description":"True when the workspace has no credits left. No tracked media is read until credits are added."},"paused_since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When tracking paused for lack of credits. Null while tracking runs, or when the workspace never held credits."},"expiring_soon":{"type":"array","items":{"type":"object","properties":{"credits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits left in this batch."},"expires_at":{"type":"string","format":"date-time","description":"When the credits left in this batch expire."}},"required":["credits","expires_at"],"additionalProperties":false},"description":"Batches of credits that expire in the next 14 days, soonest first."},"next_expiry":{"anyOf":[{"type":"object","properties":{"credits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits left in this batch."},"expires_at":{"type":"string","format":"date-time","description":"When the credits left in this batch expire."}},"required":["credits","expires_at"],"additionalProperties":false},{"type":"null"}],"description":"The batch of credits that expires first. Null when no credits are left."},"spent_last_7_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits used in the last 7 days."},"spent_last_30_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits used in the last 30 days."},"days_covered":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"How many days the balance lasts at the rate of your active tracked media. The rate is each media at its cadence and geo price, plus the daily geo account fee. Null when no tracked media are active, or the balance is 0 or less."},"auto_top_up":{"anyOf":[{"type":"object","properties":{"enabled":{"type":"boolean"},"trigger_credits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"A credit pack is bought when the balance falls below this number."},"pack":{"type":"string","description":"The credit pack that is bought: `starter`, `growth`, `pro`, `business` or `scale`. Accept values you do not know."},"monthly_limit_cents":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"The most auto top-up spends in a calendar month, in US cents. Null means no limit."},"has_card":{"type":"boolean","description":"True when a card is saved for auto top-up."},"disabled_reason":{"description":"Why auto top-up turned itself off: `declined` or `dispute`. Null when it did not. Accept values you do not know.","type":["string","null"]}},"required":["enabled","trigger_credits","pack","monthly_limit_cents","has_card","disabled_reason"],"additionalProperties":false},{"type":"null"}],"description":"Auto top-up settings. Null when they were never set. Change them on the Billing page of the console."}},"required":["balance","tracking_paused","paused_since","expiring_soon","next_expiry","spent_last_7_days","spent_last_30_days","days_covered","auto_top_up"],"additionalProperties":false},"example":{"balance":412350,"tracking_paused":false,"paused_since":null,"expiring_soon":[{"credits":20000,"expires_at":"2026-11-02T09:15:00.000Z"}],"next_expiry":{"credits":20000,"expires_at":"2026-11-02T09:15:00.000Z"},"spent_last_7_days":61810,"spent_last_30_days":248440,"days_covered":46,"auto_top_up":{"enabled":true,"trigger_credits":100000,"pack":"growth","monthly_limit_cents":50000,"has_card":true,"disabled_reason":null}}}}},"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"}}}}},"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"}}}}}}}},"/credits/usage":{"get":{"operationId":"credits-usage","summary":"List credit usage per day","tags":["Credits"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"from","schema":{"type":"string","format":"date"}},{"in":"query","name":"to","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","format":"date","description":"First UTC day included."},"to":{"type":"string","format":"date","description":"Last UTC day included."},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"The UTC day."},"project_id":{"anyOf":[{"type":"string","pattern":"^prj_[0-9a-f]{24}$"},{"type":"null"}],"description":"The project the reads belong to. Null for the daily geo account cost, which belongs to the workspace."},"resource_type":{"type":"string","description":"What used the credits: `media` (reads of tracked media), `geo_read` (the geo cost added to each read, while the account has audience data) or `account` (the daily geo account cost). Accept values you do not know."},"reads":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Successful reads on this day."},"credits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits these reads used."}},"required":["date","project_id","resource_type","reads","credits"],"additionalProperties":false},"description":"One row per day, project and type, oldest day first. Days with no reads have no row."}},"required":["from","to","data"],"additionalProperties":false},"example":{"from":"2026-10-21","to":"2026-10-22","data":[{"date":"2026-10-21","project_id":"prj_5f9c0a1b2c3d4e5f60718293","resource_type":"media","reads":612,"credits":7344},{"date":"2026-10-21","project_id":"prj_5f9c0a1b2c3d4e5f60718293","resource_type":"geo_read","reads":204,"credits":816},{"date":"2026-10-21","project_id":null,"resource_type":"account","reads":3,"credits":4500},{"date":"2026-10-22","project_id":"prj_5f9c0a1b2c3d4e5f60718293","resource_type":"media","reads":598,"credits":7176}]}}}},"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"}}}}},"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"}}}}}}}}},"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.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":[]}},"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.FORBIDDEN":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Forbidden"},"code":{"type":"string","description":"The error code","example":"FORBIDDEN"},"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":"Forbidden error (403)","description":"The error information","example":{"code":"FORBIDDEN","message":"Forbidden","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.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":[]}}},"securitySchemes":{"Authorization":{"type":"http","scheme":"bearer"}}}}