# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/sattvinfo/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/sattvinfo/get-biss-keys \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-countries-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-country-channels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-hd-channels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-satellite-by-position \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-satellite-channels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-satellite-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-tv-by-country \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-tv-packages \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sattvinfo/get-ultra-hd-channels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.