# PR Newswire — 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 the latest press releases, earnings announcements, and news from PR Newswire across specific categories and organizations, with options to search by keywords or dates. Filter releases by industry, company newsrooms, and subscribe to RSS feeds for real-time updates on corporate news and financial disclosures.

**Category:** News & Media | **Website:** [prnewswire.com/](https://prnewswire.com/) | **Docs:** [parse.bot/marketplace/5d0daee6-6b3e-45c8-bcfd-458d3f27fde1/prnewswire-com-api](https://parse.bot/marketplace/5d0daee6-6b3e-45c8-bcfd-458d3f27fde1/prnewswire-com-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-prnewswire-com-api-5d0daee6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_news_releases

Fetch news releases from a specific category and optional subcategory. Category and subcategory are URL path slugs used by PR Newswire. Without a subcategory, returns all releases in the category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug (e.g. 'financial-services-latest-news'). |
| `subcategory` | string | No | Subcategory slug (e.g. 'acquisitions-mergers-and-takeovers'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_category_news_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","subcategory":"<string>"}'
```

### get_earnings_releases

Fetch the latest earnings announcements from the Financial Services category. Returns summaries of earnings-related press releases ordered by most recent.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_earnings_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_news_releases

Fetch the latest press releases from the main feed. Returns a paginated list of releases ordered by most recent. Supports page size control up to 100 results per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to fetch. |
| `pagesize` | integer | No | Number of results per page (max 100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_latest_news_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","pagesize":"<integer>"}'
```

### get_ma_press_releases

Fetch press releases specifically for Acquisitions, Mergers and Takeovers under the Financial Services category. Returns summaries ordered by most recent.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to fetch. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_ma_press_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_organization_news

Fetch news releases for a specific organization by its slug. The slug is the last path segment of the organization's newsroom URL from search_organizations results. Returns summaries ordered by most recent.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Organization slug, the last path segment of the newsroom URL (e.g. 'microsoft-corp.'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_organization_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_press_release_by_date

Fetch press releases for a specific date. Returns releases published on the given date, optionally filtered to a specific hour. Useful for retrieving historical press releases.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `day` | string | Yes | Day in DD format with leading zero (e.g. '10'). |
| `hour` | string | No | Hour in HH format, 24-hour clock (e.g. '09'). |
| `month` | string | Yes | Month in MM format with leading zero (e.g. '06'). |
| `year` | string | Yes | Year in YYYY format (e.g. '2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_press_release_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"day":"<string>","hour":"<string>","month":"<string>","year":"<string>"}'
```

### get_press_release_detail

Fetch the full content of a single press release by its URL. Returns the headline, full body text, source company, dateline, media URLs, and the canonical URL. The URL should be a full prnewswire.com press release detail page link.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the press release detail page on prnewswire.com. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_press_release_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_rss_feed

Fetch and parse the official PR Newswire RSS feed into JSON. Returns structured items with title, link, description, publication date, company, and industries. Omitting url uses the default PR Newswire news releases feed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | No | RSS feed URL to fetch. Omitting uses the default PR Newswire news releases feed. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/get_rss_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_news_releases

Search for press releases by keyword. Returns paginated results matching the query, ordered by relevance. The search covers title and body text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to fetch. |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/search_news_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### search_organizations

Search for organizations/companies registered on PR Newswire by name. Returns matching organization names, their newsroom URLs, and slugs. Coverage is limited to organizations registered as PR Newswire clients.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Company or organization name keyword to search. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prnewswire-com-api-5d0daee6/search_organizations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```