---
title: "List keyword searches"
method: GET
path: "/v1/orbit"
tags: ["Orbit"]
---

# List keyword searches

`GET /v1/orbit`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/orbit`
- Auth: HTTP bearer

Retrieve a paginated list of all keyword search jobs for the authenticated customer.

## Query parameters

- `limit` number
- `page` number

## Response `200`

Successfully retrieved list of searches

- OrbitListResponseDto
  - `data` OrbitListDataDto, required
    - `total` number, required
    - `limit` number, required
    - `offset` number, required
    - `orbits` OrbitListItemDto[], required
      - `id` string, required
      - `name` string, nullable
      - `keywords` string[], required
      - `platforms` string[], required
      - `status` string, required
      - `totalVideos` number, required: Total videos found
      - `createdAt` string, required
      - `executionTimeMs` number, nullable

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `429`: Too many requests - rate limit exceeded

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)