Simplo Videos API
The Videos API from Simplo — 1 operation(s) for videos.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getsimplo-ai:getsimplo-ai-videos-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Simplo Videos API
version: 1.0.0
servers:
- url: https://api.getsimplo.ai/v1
security:
- apiKey: []
tags:
- name: Videos
paths:
/videos:
post:
operationId: uploadVideo
summary: Upload or import a video
description: Hosts a video for a video post. Send an MP4 or MOV (up to 100 MB) as multipart/form-data in the file field, with projectId in the query string, or send JSON with a public url for Simplo to fetch, with projectId in the body or the query. The upload is streamed, never held in memory. Pass coverAt (in the query for an upload) to take the cover from a later second. Pass the returned video to Create a post as video.
parameters:
- name: projectId
in: query
required: false
description: The project that owns the video. Required for an upload.
schema:
type: string
- name: coverAt
in: query
required: false
description: The second of the video its cover is taken from, less than its length; the first frame without it. Create a post and Edit a post take it too.
schema:
type: number
minimum: 0
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
projectId:
description: Required here or in the query string.
type: string
url:
type: string
format: uri
description: A public MP4 or MOV link for Simplo to fetch.
coverAt:
description: The second of the video its cover is taken from, less than its length; the first frame without it. Create a post and Edit a post take it too.
type: number
minimum: 0
required:
- url
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
description: MP4 or MOV, up to 100 MB
required:
- file
responses:
'201':
description: Created
content:
application/json:
schema:
type: object
properties:
video:
type: object
properties:
url:
type: string
coverUrl:
type: string
durationSeconds:
type: number
width:
type: number
height:
type: number
bytes:
type: number
required:
- url
- coverUrl
- durationSeconds
- width
- height
- bytes
additionalProperties: false
required:
- video
additionalProperties: false
'400':
description: 'The request is not valid. Error code: validation_error.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: 'Missing or invalid API key. Error code: invalid_api_key.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: 'Not allowed. Error code: subscription_inactive.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: 'Not found. Error code: not_found.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: 'Payload too large. Error code: video_too_large.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: 'Too many requests. Error code: rate_limited.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
'500':
description: 'Something went wrong on our side. Error code: internal_error.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: 'A platform or AI provider failed. Error code: upstream_error.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Videos
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
enum:
- invalid_api_key
- forbidden
- not_found
- validation_error
- invalid_schedule_time
- platform_not_available
- already_published
- publishing_in_progress
- conflict
- idempotency_key_reused
- idempotency_in_progress
- insufficient_credits
- subscription_inactive
- video_too_large
- file_too_large
- upload_link_invalid
- rate_limited
- upstream_error
- internal_error
description: A stable machine-readable code, e.g. validation_error.
message:
type: string
description: A human-readable explanation.
details:
description: Extra context, such as the failing fields of a validation_error.
securitySchemes:
apiKey:
type: http
scheme: bearer
description: smp_live_… key from Settings → API keys
x-provenance:
method: harvested
publisher: Simplo
source: https://getsimplo.ai/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)