# Sttinfo — 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 browse Finnish stock exchange announcements from STT Info's database of approximately 10,000 listings, with support for keyword filtering and paginated results. Stay informed on corporate disclosures and market-relevant news from companies trading on Finnish exchanges.

**Category:** Finance & Markets | **Website:** [www.sttinfo.fi/](https://www.sttinfo.fi/) | **Docs:** [parse.bot/marketplace/4e1df81b-92fa-41c6-bbcb-0a27e45b9343/sttinfo-fi-api](https://parse.bot/marketplace/4e1df81b-92fa-41c6-bbcb-0a27e45b9343/sttinfo-fi-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-sttinfo-fi-api-4e1df81b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_porssitiedotteet

Get paginated stock exchange announcements (Pörssitiedotteet) from STT Info. Returns headlines, publishers, dates, and categories. The response includes total_pages so you know the valid page range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for announcement titles. Accepts: fi, en, sv, no, da. Falls back to first available language if requested language not found. |
| `page` | integer | No | Page number starting from 0. Valid range is 0 to total_pages-1 (total_pages is returned in the response). For example, if total_pages is 1993, valid values are 0 through 1992. |
| `size` | integer | No | Number of announcements per page. Must be between 1 and 100. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sttinfo-fi-api-4e1df81b/get_porssitiedotteet \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","page":"<integer>","size":"<integer>"}'
```

### search_announcements

Search stock exchange announcements by keyword. Returns matching announcements with headlines, publishers, dates, and categories. The response includes total_pages so you know the valid page range for the search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for announcement titles. Accepts: fi, en, sv, no, da. Falls back to first available language if requested language not found. |
| `page` | integer | No | Page number starting from 0. Valid range is 0 to total_pages-1 (total_pages is returned in the response). For example, if a search returns total_pages=109, valid values are 0 through 108. |
| `query` | string | Yes | Search keyword to filter announcements (e.g. company name or topic). |
| `size` | integer | No | Number of announcements per page. Must be between 1 and 100. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sttinfo-fi-api-4e1df81b/search_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","page":"<integer>","query":"<string>","size":"<integer>"}'
```