# Search Shorts

> Search Shorts is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Search for real-time short-form videos across the web with filtering by date, quality, and captions.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-shorts-search/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-search-shorts-2a6086d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uJ0Y_kEzitLIVr7BDRs-U

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-search-shorts-2a6086d1
```

Example prompt: Search for short videos about 'AI breakthroughs' posted in the last week — show me only high-quality results with closed captions, starting from page 1.

## When to prefer this

Use this endpoint when you need real-time short-form video search results (e.g. YouTube Shorts or similar) across the web, especially when filtering by recency, quality, or accessibility (closed captions) matters. Prefer this over general video search endpoints when the user specifically wants short-format vertical video content, or when pagination through results is needed.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Invalid date format for posted_date_from or posted_date_to may return no results or an error
- Requesting a page beyond available results returns an empty data array
- Network or upstream API timeout returns a non-200 status
- Invalid enum value for 'time' parameter may cause a bad request error

## How this service works

Get real-time short video search results from across the web with pagination and filtering support.

## Output

Returns a paginated array of short video results, each containing a unique video ID, title, source platform, channel name, thumbnail image URL, video URL, aspect ratio, rank, and position in results, along with response status, request ID, and echoed query parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "number",
   "default": 1,
   "description": "Results page to return (pagination / scrolling)"
  },
  "time": {
   "enum": [
    "any",
    "day",
    "week",
    "month",
    "year"
   ],
   "type": "string",
   "default": "any",
   "description": "Find shorts posted in a specific relative time range."
  },
  "query": {
   "type": "string",
   "description": "Search query / keyword."
  },
  "high_quality": {
   "type": "boolean",
   "description": "Return only shorts of high quality."
  },
  "posted_date_to": {
   "type": "string",
   "description": "Find shorts posted before a specific date (e.g. 3/19/2025)."
  },
  "closed_captioned": {
   "type": "boolean",
   "description": "Return only shorts with closed captions."
  },
  "posted_date_from": {
   "type": "string",
   "description": "Find shorts posted after a specific date (e.g. 1/19/2025)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "description": "The unique identifier of the video result"
     },
     "rank": {
      "type": "integer",
      "description": "Overall rank of the video in search results"
     },
     "title": {
      "type": "string",
      "description": "The title of the video"
     },
     "source": {
      "type": "string",
      "description": "The source platform of the video"
     },
     "position": {
      "type": "integer",
      "description": "Position of the video in the result list"
     },
     "image_url": {
      "type": "string",
      "description": "URL of the thumbnail image for the video"
     },
     "video_url": {
      "type": "string",
      "description": "URL where the video can be viewed"
     },
     "aspect_ratio": {
      "type": "number",
      "description": "Aspect ratio of the video"
     },
     "channel_name": {
      "type": "string",
      "description": "The name of the channel that published the video"
     }
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the API response"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "page": {
     "type": "string",
     "description": "The page number or token used for pagination"
    },
    "query": {
     "type": "string",
     "description": "The search query string used in the request"
    }
   }
  },
  "request_id": {
   "type": "string",
   "description": "A unique identifier for the API request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-search-shorts-2a6086d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)