---
title: "GET /api/feed/v1/search"
method: GET
path: "/api/feed/v1/search"
tags: ["Feed"]
---

# GET /api/feed/v1/search

`GET /api/feed/v1/search`

## Request

- Base URL: `https://api.findticker.com`
- URL: `https://api.findticker.com/api/feed/v1/search`
- Auth: HTTP bearer

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Events and performers whose name matches. Ids here are what the reading routes take. Costs one unit: search returns ids, not readings.

- FeedSearchResponse
  - `events` FeedSearchEvent[], required
    - `event_id` string, nullable, required
    - `event_name` string, nullable, required
    - `local_date` string, nullable, required
    - `utc_date` string, nullable, required
    - `venue_name` string, nullable, required
    - `city` string, nullable, required
  - `performers` FeedSearchPerformer[], required
    - `performer_id` string, required
    - `name` string, nullable, required
  - `meta` object, required
    - `q` string, required
    - `limit` integer, required
    - `enumeration` 'not supported', required

## Other responses

- `400`: Validation error, an unknown `columns` name (the message lists the valid set), or a batch over the size bound.
- `401`: Missing or invalid API key.
- `403`: The key's account is not entitled to the feed, or the account or the address it calls from is blocked (`reason` `blocked`).
- `429`: The per-minute burst ceiling or the unit budget for the current UTC date is used up.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/findticker/apis/ticker-api.md) · [All operations](https://skmtc.dev/findticker/apis/ticker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findticker/apis/ticker-api/revisions/b6229ca924f4?raw)