# Rusprofile — 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 Russian companies and retrieve their detailed profiles including financial information, registration details, and director information from Rusprofile's database. Look up director credentials by their tax identification number and discover company relationships and links.

**Category:** Business Directories | **Website:** [rusprofile.ru/](https://rusprofile.ru/) | **Docs:** [parse.bot/marketplace/7f6e9a42-4605-4dd5-bd42-dd074326cae7/rusprofile-ru-api](https://parse.bot/marketplace/7f6e9a42-4605-4dd5-bd42-dd074326cae7/rusprofile-ru-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-rusprofile-ru-api-7f6e9a42/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### extract_links

Extract all hyperlinks from a given Rusprofile page path or a specific section of the page defined by a CSS selector. Returns an array of link objects with text and href. Useful for discovering related pages, affiliated companies, or navigation links from any rusprofile.ru page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Page path on rusprofile.ru (e.g. '/id/2835629'). |
| `section_selector` | string | No | CSS selector to limit extraction to a specific section of the page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rusprofile-ru-api-7f6e9a42/extract_links \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>","section_selector":"<string>"}'
```

### get_company_profile

Get a detailed company profile by Rusprofile internal ID. Returns company name, INN, OGRN, and director information including full name (FIO), personal INN, role, and profile link. The director's personal INN is extracted from the profile page URL pattern or by following the director's profile link.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_id` | string | Yes | Rusprofile internal company ID (from search_companies results, e.g. '2835629'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rusprofile-ru-api-7f6e9a42/get_company_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_id":"<string>"}'
```

### get_director_details

Get director info (FIO and INN) for a company identified by ID or search query. When company_id is provided, fetches the profile directly. When query is provided, searches for the company and returns the profile of the first match including director details. Either company_id or query must be provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_id` | string | No | Rusprofile internal company ID (from search_companies results). |
| `query` | string | No | Search query to find the company (name, INN, or OGRN). Used when company_id is not provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rusprofile-ru-api-7f6e9a42/get_director_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_id":"<string>","query":"<string>"}'
```

### search_companies

Search for companies by name, INN, OGRN, or address via the advanced search API. Returns a paginated list of matches with basic info including name, INN, OGRN, address, CEO name, and internal ID. Results are sorted by revenue by default. Up to 50 results per page, auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Address filter — city, street, or full registered address string (e.g. 'Санкт-Петербург Лахтинский'). Combined with query when both are provided. At least one of query or address must be provided. |
| `page` | integer | No | Page number (1-based). |
| `query` | string | No | Search query — company name, INN, or OGRN. At least one of query or address must be provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rusprofile-ru-api-7f6e9a42/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","page":"<integer>","query":"<string>"}'
```