---
title: "Search N videos"
method: GET
path: "/vids"
tags: ["Videos"]
---

# Search N videos

`GET /vids`

Do simple video listing or do advanced video search with filters, sorting, pagination, facets and counting

## Query parameters

- `q` string — Query filtering formula, must be url-encoded. Similarity uses i~, i~~, i~~~ for semantic similarity search and i=, i==, i=== for visual duplicate-detection search. i==== requests an additional, more precise duplicate-verification pass on the top candidate, slightly slower than the other comparisons; this mode is currently restricted to selected tenants.
- `page` integer — Page number. 1 is the first page.
- `limit` integer — Maximum number of videos to return per page
- `sort_by` '' | 'id' | 'src' | 'title' | 'headline' | 'date' | 'date_jdn' | 'duration_secs' | 'height' | 'width' — Sorting criterion. Note that sort_by=similarity only works if there are present "similary filters" on the Query Filtering Formula.
- `sort_order` 'asc' | 'desc' — Ascending or descending sorting.
- `fields` string[] — Array of fields to retrieve. Example: fields=image_id&fields=src
- `facets` string[] — Array of facets to retrieve. Example: facets=author&facets=keywords
- `count` boolean — Include total hit count?
- `lang` 'ml' | 'en' | 'es' — Language code.

## Response `200`

Successful Response

- VideoSearchResponse
  - `results` Video[], required
    - `video_id` string, nullable
    - `src` string, nullable — URL del vídeo original.
    - `thumbnail_url` string, nullable — Nombre canónico backend para la miniatura del vídeo.
    - `preview_url` string, nullable — Nombre canónico backend para el preview reproducible del vídeo.
    - `img_src` string, nullable — Alias temporal de compatibilidad frontend para `thumbnail_url`.
    - `img_zoom` string, nullable — Alias temporal de compatibilidad frontend para `preview_url`.
    - `date` string, nullable — Fecha del vídeo en formato YYYY-MM-DD.
    - `location` string, nullable — Localización descriptiva del vídeo.
    - `city` string, nullable — Ciudad.
    - `country` string, nullable — País.
    - `event` string, nullable — Evento relacionado.
    - `author` string, nullable — Autor o creador.
    - `provider` string, nullable — Proveedor o agencia.
    - `keywords` string[], nullable — Palabras clave.
    - `categories` string[], nullable — Categorías.
    - `collections` string[], nullable — Colecciones.
    - `title` string, nullable — Título.
    - `headline` string, nullable — Titular.
    - `description` string, nullable — Descripción.
    - `alt_text` string, nullable — Texto alternativo.
    - `status` string, nullable — Estado editorial del vídeo.
    - `medium` string, nullable — Medio o tipo editorial.
    - `ai_generated` boolean, nullable — Indica si fue generado por IA.
    - `model_release` boolean, nullable — Indica si tiene model release.
    - `property_release` boolean, nullable — Indica si tiene property release.
    - `nsfw` boolean, nullable — Indica si está marcado como NSFW.
    - `container` string, nullable — Contenedor del vídeo, por ejemplo MP4.
    - `codec_video` string, nullable — Codec de vídeo, por ejemplo H264.
    - `codec_audio` string, nullable — Codec de audio, por ejemplo AAC.
    - `height` integer, nullable — Alto del vídeo.
    - `width` integer, nullable — Ancho del vídeo.
    - `aspect_ratio` number, nullable — Aspect ratio del vídeo.
    - `fps` number, nullable — Frames por segundo.
    - `duration_secs` number, nullable — Duración del vídeo en segundos.
    - `id` string, nullable — Identificador único del vídeo.
  - `count` integer, required
  - `facets` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/wesog/apis/wesog-api.md) · [All operations](https://skmtc.net/wesog/apis/wesog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wesog/wesog-api/revisions/97381dd1ff4c/schema)