# Bitcointalk — 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 BitcoinTalk forum data to browse boards, search threads, read posts, and view user profiles all in one place. Quickly find recent discussions and explore community activity without visiting the forum directly.

**Category:** Web3 & Onchain | **Website:** [bitcointalk.org/](https://bitcointalk.org/) | **Docs:** [parse.bot/marketplace/f174cb2c-3cfe-45ee-88b4-c372f6096bfa/bitcointalk-org-api](https://parse.bot/marketplace/f174cb2c-3cfe-45ee-88b4-c372f6096bfa/bitcointalk-org-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-bitcointalk-org-api-f174cb2c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_board_threads

Retrieve a list of threads from a specific board. Returns paginated results with up to 40 threads per page. Each thread includes title, topic_id, starter username and ID, reply count, view count, and last post info. Use the start parameter to paginate in increments of 40.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_id` | string | Yes | Numeric ID of the board (from get_forum_boards results, e.g. '1' for Bitcoin Discussion). |
| `start` | integer | No | Pagination offset in increments of 40. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bitcointalk-org-api-f174cb2c/get_board_threads \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_id":"<string>","start":"<integer>"}'
```

### get_forum_boards

Retrieve the main forum index with all categories and their boards. Returns the full hierarchy of forum categories, each containing a list of boards with metadata including board name, ID, description, post count, and topic count. This is the entry point for discovering board IDs to use with get_board_threads.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bitcointalk-org-api-f174cb2c/get_forum_boards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_recent_posts

Retrieve the most recent posts forum-wide. Returns paginated results with 10 posts per page. Each post includes the thread title, URL, metadata about author, and a content snippet. Use the start parameter to paginate in increments of 10.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `start` | integer | No | Pagination offset in increments of 10. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bitcointalk-org-api-f174cb2c/get_recent_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"<integer>"}'
```

### get_thread_posts

Retrieve all posts within a specific thread. Returns paginated results with up to 20 posts per page. Each post includes post_id, author info, timestamp, and full content text. Use the start parameter to paginate in increments of 20.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `start` | integer | No | Pagination offset in increments of 20. |
| `topic_id` | string | Yes | Numeric ID of the topic/thread (from get_board_threads results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bitcointalk-org-api-f174cb2c/get_thread_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"<integer>","topic_id":"<string>"}'
```

### get_user_profile

Retrieve a user's public profile information including username, post count, activity level, merit, registration date, and last active time. Some fields may be absent if the user has not set them.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `user_id` | string | Yes | Numeric ID of the user (from thread starter_id or post author_id fields). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bitcointalk-org-api-f174cb2c/get_user_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"<string>"}'
```