The ArabicShortsAi API: projects, the factory, publishing, and Webhooks
A practical guide to the API in ArabicShortsAi: creating keys, starting video processing, following projects, managing the factory, scheduling and publishing, analytics, and Webhooks.
One interface for the same account and the same balance
The API uses the same ArabicShortsAi account, the same minute balance, and the same plan limits. There is no separate API plan, and read requests and analytics do not deduct video-processing minutes.
Keys and permissions
From the API page inside the account you can create a key with permissions that fit the use: read and follow, production and processing, publishing and scheduling, or full access. The full key appears only once, and the system stores its fingerprint instead of the original text.
The account and projects
GET /api/v1/account returns the plan, the balance, and the limits. GET /api/v1/projects lists the projects, POST /api/v1/projects starts processing a video link or a file that was uploaded, and GET /api/v1/projects/{id} returns the status. The /api/v1/projects/{id}/review route shows the suggestions, approves or edits the selections, and starts a render of the approved clips.
Uploading video files
For large files, use POST /api/v1/uploads/multipart to create a multipart upload, sign the parts, complete the upload, or cancel it. After the upload is complete, pass r2_key, upload_token, and source_name to POST /api/v1/projects. The same ownership, file-type, and duration checks used on the site apply to the API.
Channels and the Shorts factory
GET /api/v1/channels lists the channels and the factory status. POST /api/v1/channels connects a YouTube or Kick channel after the rights acknowledgement, and it can be used to turn monitoring on or off and to choose an earlier video for processing according to the plan limits and the balance.
Publishing and scheduling
GET /api/v1/publishing/connections lists the connected publishing accounts. The /api/v1/publishing/schedules route supports reading, creating, rescheduling, cancelling, and a safe retry, with connection_id specified when there is more than one account for the same platform.
Analytics
GET /api/v1/analytics returns a summary for the requested period about projects, source minutes, clips, publishing statuses, platforms, and factory channels, in addition to the current account balance.
Webhooks instead of repeated checking
Webhooks can be managed from /api/v1/webhooks. The system supports project, publishing, and channel events, and it signs every request using HMAC SHA-256 in the X-ASA-Signature header. The signing secret appears once when a Webhook is created and is stored encrypted.
A quick connection example
Send your key in X-API-Key to https://arabicshortsai.com/api/v1/account. The same key is used for the rest of the routes according to the permissions you chose, and it can be revoked from your account so that it stops immediately.