# Payload Space — 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.

> Search and retrieve space industry news articles, company information, funding rounds, contract awards, and events from Payload Space's comprehensive database. Stay updated on latest developments across commercial space, military space, European space news, and industry events like webinars and podcasts.

**Category:** News & Media | **Website:** [payloadspace.com/](https://payloadspace.com/) | **Docs:** [parse.bot/marketplace/77ce75a8-b9aa-4974-9701-0d00a74d3ff9/payloadspace-com-api](https://parse.bot/marketplace/77ce75a8-b9aa-4974-9701-0d00a74d3ff9/payloadspace-com-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/payload-space/`
**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

### Extract companies from article

Extract all company mentions from a specific article using heuristic name extraction from the article content. Returns potential company names with inferred industry and contextual excerpt.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Article slug identifier (from get_latest_articles or search_articles results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/extract-companies-from-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get all companies mentioned

Fetch the 20 most recent articles and aggregate unique company mentions site-wide using heuristic name extraction. Deduplicates by company name, keeping the longest contextual description.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-all-companies-mentioned \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get article detail

Fetch the full content and metadata of a specific article by its slug. Also includes extracted company mentions derived via heuristic name extraction from the article content. Returns a single article object (not an array).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Article slug identifier (from get_latest_articles or search_articles results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-article-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get articles by category

Fetch articles filtered by category slug. Returns articles in the specified category ordered by publication date descending. Category slugs map to internal WordPress category IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug to filter by. Known working values: 'business', 'launch', 'vc-pe', 'military', 'europe', 'polaris'. |
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-articles-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>"}'
```

### Get companies from category

Aggregate company mentions from up to 20 articles in a specific category using heuristic name extraction. Deduplicates by company name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug to filter by. Known working values: 'business', 'launch', 'vc-pe', 'military', 'europe', 'polaris'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-companies-from-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### Get contract awards

Fetch articles related to contract awards by searching for 'contract' keyword across all articles. Equivalent to search_articles with query='contract'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-contract-awards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get europe space news

Fetch articles from the Europe category, covering European space industry developments. Equivalent to get_articles_by_category with category='europe'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-europe-space-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get events

Fetch space industry events hosted or promoted by Payload Space. Uses the WordPress custom post type 'event'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of events to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get funding rounds

Fetch articles from the VC/PE category, covering funding rounds and investment news in the space industry. Equivalent to get_articles_by_category with category='vc-pe'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-funding-rounds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get latest articles

Fetch the most recent articles from Payload Space, ordered by publication date descending. Returns full article content including HTML markup in content and summary fields. Categories and tags are returned as integer IDs referencing internal WordPress taxonomy.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-latest-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get launch news

Fetch articles from the Launch category, covering rocket launches and launch vehicle developments. Equivalent to get_articles_by_category with category='launch'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-launch-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get military space news

Fetch articles from the Military category, covering defense and national security space developments. Equivalent to get_articles_by_category with category='military'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-military-space-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get podcasts

Fetch Payload Space podcast episodes (Valley of Depth series), ordered by date descending. Uses the WordPress custom post type 'podcast'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of podcast episodes to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-podcasts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get polaris news

Fetch articles from the Polaris category, covering space policy and regulatory developments. Equivalent to get_articles_by_category with category='polaris'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-polaris-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get webinars

Fetch Payload Space webinars, ordered by date descending. Uses the WordPress custom post type 'webinar'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of webinars to return (1-100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/get-webinars \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Search articles

Search for articles by keyword. Returns articles matching the search query ordered by relevance. Uses WordPress full-text search across title and content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return (1-100). |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/payload-space/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<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.