# Globenewswire — 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 press releases, earnings announcements, and M&A news from GlobeNewswire by searching across industries, organizations, and specific topics to stay informed on corporate developments. Browse detailed information on company announcements and subscribe to RSS feeds for real-time updates on organizations relevant to your interests.

**Category:** News & Media | **Website:** [globenewswire.com/](https://globenewswire.com/) | **Docs:** [parse.bot/marketplace/5516b700-d512-4ea8-a8aa-6d2822b89019/globenewswire-com-api](https://parse.bot/marketplace/5516b700-d512-4ea8-a8aa-6d2822b89019/globenewswire-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-globenewswire-com-api-5516b700/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_by_industry

Browse press releases filtered by industry. Returns paginated results for the specified industry sector. Industry values include broad categories like 'Financials', 'Consumer Services', 'Industrials', and more specific ones like 'Financial Services' or 'Industrial Goods & Services'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `industry_slug` | string | Yes | Industry name to filter by (e.g., 'Financials', 'Consumer Services', 'Industrials', 'Industrial Goods & Services', 'Financial Services'). |
| `page` | integer | No | Page number for pagination. |
| `pageSize` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-globenewswire-com-api-5516b700/browse_by_industry \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"industry_slug":"<string>","page":"<integer>","pageSize":"<integer>"}'
```

### get_press_release_detail

Fetch full content and metadata of a specific press release by its URL. Returns the complete article text, publication date, source, keywords, ticker symbols, and contact information. The URL is typically obtained from search_press_releases or browse_by_industry results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the press release (e.g., from search_press_releases results[*].url). |

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

### get_rss_feed_by_organization

Retrieve the RSS feed for a specific organization by its base64-encoded ID. Returns structured feed items including title, link, description, publication date, and categorization metadata. Organization IDs are base64-encoded strings typically found in GlobeNewswire organization URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `org_id` | string | Yes | Base64-encoded organization ID (e.g., 'YAUjHw9hB786FVeQ2UIrjw=='). Numeric IDs are not accepted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-globenewswire-com-api-5516b700/get_rss_feed_by_organization \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"org_id":"<string>"}'
```

### search_earnings_announcements

Search for earnings announcements and operating results press releases. Returns paginated results of quarterly and annual earnings reports, revenue announcements, and financial results disclosures.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `pageSize` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-globenewswire-com-api-5516b700/search_earnings_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","pageSize":"<integer>"}'
```

### search_ma_press_releases

Search for press releases related to Mergers and Acquisitions. Returns paginated results of M&A-related announcements including acquisitions, mergers, and corporate restructuring news.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `pageSize` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-globenewswire-com-api-5516b700/search_ma_press_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","pageSize":"<integer>"}'
```

### search_press_releases

Search for press releases by keyword or with various filters. Returns paginated results from GlobeNewswire's search. When no query is provided, returns the latest press releases. Supports filtering by industry, subject, and date range. Each result is a summary; use the URL to fetch full details via get_press_release_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dateRange` | string | No | Date range preset for filtering results. |
| `endDate` | string | No | End date for custom range in YYYY-MM-DD format. Used with dateRange='custom'. |
| `industry` | string | No | Industry filter value (e.g., 'Financials', 'Consumer Services', 'Industrials'). |
| `lang` | string | No | Language code for results. |
| `page` | integer | No | Page number for pagination. |
| `pageSize` | integer | No | Number of results per page. |
| `query` | string | No | Search keyword. When omitted, returns latest press releases. |
| `startDate` | string | No | Start date for custom range in YYYY-MM-DD format. Used with dateRange='custom'. |
| `subject` | string | No | Subject filter value. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-globenewswire-com-api-5516b700/search_press_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dateRange":"<string>","endDate":"<string>","industry":"<string>","lang":"<string>","page":"<integer>","pageSize":"<integer>","query":"<string>","startDate":"<string>","subject":"<string>"}'
```
