---
title: "New-launch feed"
method: GET
path: "/launches"
---

# New-launch feed

`GET /launches`

## Request

- Base URL: `https://firstsited.com/api/v1`
- URL: `https://firstsited.com/api/v1/launches`
- Auth: HTTP bearer

Launches in reverse chronological order, filterable by technology, category and country. Plans without the feed scope can retrieve the same rows through /export.

Requires the `feed` scope. Available on: pro, firehose.

## Query parameters

- `limit` integer
- `cursor` string
- `offset` integer
- `observed_since` string
- `has_email` string
- `has_contact_url` string
- `observed_until` string
- `since` string
- `until` string
- `tech` string
- `keywords` string
- `near` string
- `radius` string
- `category` string
- `country` string
- `launch_type` string
- `indie` boolean
- `include` string
- `min_confidence` number
- `min_category_confidence` number
- `min_country_confidence` number

## Response `200`

Success.

- object

## Other responses

- `400`: A required parameter is missing or malformed.
- `401`: No usable key. While the API is unannounced this is masked as 404.
- `403`: The key or plan does not carry the required scope.
- `429`: Quota exhausted (`monthly_credits_exhausted` or `distinct_launch_ceiling_reached`), or the per-key rate limit was exceeded, which returns a plain-text body rather than JSON.

## Changes

- **2026-10-20** `01db728020dd`: 2 info
  - added the new optional `query` request parameter `near`
  - added the new optional `query` request parameter `radius`

[Operation history](https://skmtc.dev/stackscope/apis/firstsited-api/changes/launches/get.md)

---

[API](https://skmtc.dev/stackscope/apis/firstsited-api.md) · [All operations](https://skmtc.dev/stackscope/apis/firstsited-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackscope/apis/firstsited-api/revisions/01db728020dd?raw)