Sora.ai API - Search & Download AI-Generated Videos

Search and download AI-generated videos and images from OpenAI's Sora platform by keyword. Extract prompts, metadata, and media files.

Features

• Keyword Search - Find AI generations by any search term
• Media Downloads - Save thumbnails, GIFs, and full videos to Apify KV Store
• Complete Metadata - Prompts, creator info, dimensions, likes, remix data
• Pagination - Scrape up to 10,000 results per run

Input Parameters

Parameter	Type	Default	Description
query	string	cars	Search keyword
maxResults	integer	1000	Maximum items to scrape (1-10,000)
downloadThumbs	boolean	true	Download thumbnail images
downloadGif	boolean	true	Download preview GIFs
downloadVideos	boolean	false	Download full video files (5-50MB each)

Output Example

{
  "id": "gen_01jwkjdj4se4ybgxc5wk5nk7vv",
  "taskId": "task_01jwkjbhc4eq1rrnbb6gkpzygm",
  "createdAt": "2025-05-31T16:22:26.129434Z",
  "title": "Cyberpunk Agent Descent",
  "prompt": null,
  "taskType": "video_gen",
  "username": "annavision",
  "user": {
    "id": "user-pbzrSWzXjVd2NFPPSXlD4HAz",
    "username": "annavision"
  },
  "likeCount": 5,
  "isPublic": true,
  "nFrames": 150,
  "width": 480,
  "height": 720,
  "seed": 880177176,
  "durationSecs": 5.0,
  "operation": "storyboard",
  "model": "turbo",
  "actions": {
    "0": "A mysterious female agent with piercing blue eyes stands atop a skyscraper...",
    "44": "The agent steps off the skyscraper edge, transforming into a shadowy blur...",
    "100": "She lands silently in a narrow alley, her eyes softly glowing..."
  },
  "canDownload": true,
  "downloadStatus": "ready",
  "numChildren": 0,
  "sourceSize": 2511170,
  "urls": {
    "main": "https://videos.openai.com/.../watermarked.mp4",
    "source": "https://videos.openai.com/.../source.mp4",
    "thumbnail": "https://videos.openai.com/.../thumb.webp",
    "md": "https://videos.openai.com/.../md.mp4",
    "ld": "https://videos.openai.com/.../ld.mp4",
    "spritesheet": "https://videos.openai.com/.../sprite.jpg",
    "gif": null
  },
  "downloads": {
    "thumbnail": "https://api.apify.com/v2/key-value-stores/.../records/...",
    "video": "https://api.apify.com/v2/key-value-stores/.../records/..."
  }
}

Pricing (Pay Per Event)

Event	Price	Description
actor_start	$0.01	Per run
item_scraped	$0.001	Per generation found
image_scraped	$0.002	Per thumbnail/GIF downloaded
video_scraped	$0.01	Per video downloaded

Cost Examples

Scenario	Items	Downloads	Cost
Metadata only	100	0	$0.11
With thumbnails	100	100 thumbs	$0.31
With videos	100	100 videos	$1.11
Large scrape	1,000	0	$1.01

Quick Start

Basic (metadata only)

{
  "query": "nature",
  "maxResults": 100,
  "downloadThumbs": false,
  "downloadGif": false
}

With Downloads

{
  "query": "cyberpunk",
  "maxResults": 500,
  "downloadThumbs": true,
  "downloadGif": true,
  "downloadVideos": false
}

API Integration

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("your-username/sora-ai-api").call(run_input={
    "query": "robots",
    "maxResults": 50
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']}: {item['prompt'][:50]}...")

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('your-username/sora-ai-api').call({
    query: 'robots',
    maxResults: 50
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => console.log(item.title, item.prompt));

📧 Support

• Email: max@mapa.slmail.me
• Feature Requests: Email or submit via issues
• Response Time: Typically within 24 hours