# Sattvinfo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access satellite TV information including channels, transponders, BISS keys, and packages organized by satellite, country, and HD/Ultra HD availability. Search and browse satellite positions, filter content by region, and find specific TV packages to discover available broadcasting options.

**Category:** Entertainment | **Website:** [sattvinfo.net/](https://sattvinfo.net/) | **Docs:** [parse.bot/marketplace/386294e0-b434-4792-8ba5-79c0466b71b7/sattvinfo-net-api](https://parse.bot/marketplace/386294e0-b434-4792-8ba5-79c0466b71b7/sattvinfo-net-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_biss_keys

Get BISS encryption keys for satellite channels. Returns channel names, satellites, frequencies, and key values. Some keys may show '-' when currently unavailable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_biss_keys \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_countries_list

Get the list of countries for which satellite TV channel data is available. Each country has a two-letter code usable with get_country_channels.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_countries_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_country_channels

Get channels available in a specific country. Returns satellite TV channels with frequency, provider, and footprint data for the given country.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | Yes | Two-letter country code (e.g. 'ru', 'de', 'am') from get_countries_list. |
| `lang` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_country_channels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","lang":"<string>"}'
```

### get_hd_channels

Get the list of satellites providing HD channels, with their orbital positions and frequency bands. Returns satellite-level summary; use get_satellite_channels with the sat_id for per-channel detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_hd_channels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_satellite_by_position

Lookup satellite transponders and channels by orbital position. Returns the same transponder structure as get_satellite_channels but identified by position (e.g. '13.0E') rather than satellite ID. The position is normalized internally to a sat_id lookup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |
| `position` | string | Yes | Orbital position in format like '13.0E', '28.2E', '4.0W'. The numeric value and E/W direction are required. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_satellite_by_position \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","position":"<string>"}'
```

### get_satellite_channels

Get detailed transponder and channel data for a specific satellite. Each transponder includes frequency, symbol rate, provider, and a list of channels with PIDs and encryption info. Identified by sat_id from get_satellite_list. Large satellites may return hundreds of transponders.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |
| `sat_id` | string | Yes | Satellite ID from get_satellite_list results (e.g. '1831e', '1221e', '130e'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_satellite_channels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","sat_id":"<string>"}'
```

### get_satellite_list

Get the full list of satellites with names, orbital positions, and frequency bands. Each satellite includes a sat_id usable for detailed channel lookups. Returns all tracked satellites across C, Ku, and Ka bands.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_satellite_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_tv_by_country

Get channels available in a specific country, or list all available countries when no country_code is provided. Coverage varies by country; some countries (e.g. 'ru', 'de') have extensive data while others may return empty results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Two-letter country code (e.g. 'ru', 'de', 'am'). Omitting returns the list of available countries instead of channels. Use codes from the countries list returned when this param is omitted. |
| `lang` | string | No | Language code: 'en' or 'ru'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_tv_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","lang":"<string>"}'
```

### get_tv_packages

Get the list of available satellite TV packages worldwide, each with a name and package ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_tv_packages \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_ultra_hd_channels

Get the list of satellites providing Ultra HD (4K) channels, with their orbital positions and frequency bands. Returns satellite-level summary; use get_satellite_channels with the sat_id for per-channel detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sattvinfo-net-api-386294e0/get_ultra_hd_channels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```