Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Mediaruntime Sandbox API
version: 1.0.0
description: 'Operations tagged Sandbox across 2 of this provider''s published API definitions: mediaruntime-api-openapi.yml, mediaruntime-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- description: Production
url: https://mediaruntime.com
tags:
- description: Create a bounded public-sandbox session.
name: Sandbox
paths:
/v1/sandbox/session:
post:
description: Creates a short-lived, rate-limited sandbox credential. It is not a production API key and cannot access customer accounts.
operationId: createSandboxSession
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SandboxSessionResponse'
description: Successful Response
security: []
summary: Create a sandbox session
tags:
- Sandbox
servers:
- description: Production
url: https://mediaruntime.com
components:
schemas:
SandboxSessionResponse:
properties:
account_id:
title: Account Id
type: string
account_status:
title: Account Status
type: string
can_run:
title: Can Run
type: boolean
expires_in:
title: Expires In
type: integer
sandbox_token:
title: Sandbox Token
type: string
required:
- sandbox_token
- expires_in
- account_status
- account_id
- can_run
title: SandboxSessionResponse
type: object
RateLimitErrorResponse:
description: Existing gateway error envelope for HTTP 429; codes distinguish account throttling and sandbox capacity.
properties:
detail:
description: Legacy error detail; clients should prefer error.code and error.message.
error:
properties:
code:
type: string
details:
description: Structured error context, or null.
message:
type: string
request_id:
type: string
retryable:
const: true
type: boolean
status:
const: 429
type: integer
required:
- code
- message
- status
- retryable
- request_id
- details
type: object
request_id:
type: string
required:
- error
- request_id
- detail
type: object
headers:
RetryAfter:
description: Seconds to wait before retrying a throttled request. Keep the same Idempotency-Key and request body when retrying a job submission.
example: '60'
schema:
pattern: ^[0-9]+$
type: string
RequestId:
description: Gateway correlation ID. Include this value when contacting support.
schema:
type: string
securitySchemes:
ProductionApiKey:
description: MediaRuntime server-side API key. Keep it in a secret manager and never expose it in browser or mobile code.
in: header
name: X-API-Key
type: apiKey
SandboxToken:
description: Ephemeral credential returned by POST /v1/sandbox/session for bounded sandbox jobs only.
in: header
name: X-Sandbox-Token
type: apiKey
StickerClientToken:
bearerFormat: mrt_v1
description: Short-lived token restricted to one sticker collection and an explicit runtime-operation allowlist.
scheme: bearer
type: http
WorkspaceBearer:
bearerFormat: Firebase ID token
description: Firebase ID token for a signed-in first-party workspace client. The gateway resolves and rechecks active account membership.
scheme: bearer
type: http
externalDocs:
description: MediaRuntime developer documentation
url: https://mediaruntime.com/docs
x-refined-from:
- mediaruntime-api-openapi.yml
- mediaruntime-openapi.json
x-provenance:
method: harvested
publisher: MediaRuntime
source: https://mediaruntime.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)