# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/rusprofile/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/rusprofile/extract-links \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rusprofile/get-company-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rusprofile/get-director-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rusprofile/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.