Rusprofile APIrusprofile.ru ↗
Search Russian companies by name, INN, or OGRN, retrieve director details, founders, ownership history, and charter capital from Rusprofile.ru.
What is the Rusprofile API?
The Rusprofile.ru API exposes 5 endpoints covering Russian company search, detailed profiles, director INN lookups, founder records, and ownership history. The search_companies endpoint accepts name, INN, OGRN, or address queries and returns paginated results with revenue and employee filters. The get_company_founders endpoint surfaces both current founders and historical ownership records alongside charter capital as displayed on the public page.
curl -X GET 'https://api.parse.bot/scraper/952cd99d-a90c-45b2-85e9-3467c387dd77/search_companies?page=1&query=%D0%93%D0%B0%D0%B7%D0%BF%D1%80%D0%BE%D0%BC&address=%D0%A1%D0%B0%D0%BD%D0%BA%D1%82-%D0%9F%D0%B5%D1%82%D0%B5%D1%80%D0%B1%D1%83%D1%80%D0%B3' \ -H 'X-API-Key: $PARSE_API_KEY'
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. Supports optional filters for minimum employee count, minimum annual revenue, and whether the company has filed 2025 financial statements.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| query | string | Search query — company name, INN, or OGRN. At least one of query or address must be provided. |
| address | string | 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. |
| min_revenue | integer | Minimum annual revenue in rubles. Filters results to companies with revenue at or above this value. |
| min_employees | integer | Minimum number of employees. Filters results to companies with at least this many employees. |
| filed_financials_2025 | boolean | When true, filters results to companies that have filed financial statements for 2025. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"items": "array of company summaries with id, name, inn, ogrn, address, ceo_name, link",
"total": "integer total number of matching companies",
"total_pages": "integer total number of pages"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"id": "4420786",
"inn": "7805018099",
"link": "/id/4420786",
"name": "ООО \"Газпром Трансгаз Санкт-Петербург\"",
"ogrn": "1027804862755",
"address": "196128, город Санкт-Петербург, Варшавская ул., д. 3 к. 2",
"ceo_name": "Фокин Георгий Анатольевич"
}
],
"total": 231,
"total_pages": 5
},
"status": "success"
}
}About the Rusprofile API
Search and Filter Russian Companies
The search_companies endpoint queries the Rusprofile database by company name, INN, OGRN, or registered address. Results come back paginated at up to 50 per page and include id, name, inn, ogrn, address, ceo_name, and a direct link to the company page. Optional filters let you narrow by min_revenue (in rubles), min_employees, and whether the company has filed financials for 2025 (filed_financials_2025). The total and total_pages fields make it straightforward to iterate through large result sets.
Company Profiles and Director Details
Passing a Rusprofile internal company_id to get_company_profile returns the company's inn, ogrn, name, and a structured director object containing the director's full name (name), personal INN (inn), role, and a profile link. The same director fields are available via get_director_details, which also accepts a free-text query parameter — useful when you have only a company name and want director credentials without a separate search step.
Founders and Ownership History
get_company_founders returns both current and historical ownership data. The founders array lists each founder's name, type (person or organization), and — for organizational founders — a company_id you can pass directly into get_company_profile to traverse ownership chains. The ownership_history array includes status (current or historical), period_from, and period_to dates. Supporting fields include charter_capital (formatted string in rubles), has_history (boolean), current_count, and historical_count.
Link Extraction
The extract_links endpoint accepts any Rusprofile page path (e.g. /id/2835629) and an optional section_selector CSS selector. It returns an array of {text, href} objects for every hyperlink in the specified section, making it useful for discovering affiliated company pages, subsidiary links, or any related navigation present on a given profile page.
The Rusprofile API is a managed, monitored endpoint for rusprofile.ru — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when rusprofile.ru changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official rusprofile.ru API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Verify a Russian counterparty's registration details (INN, OGRN) before entering a contract
- Look up the personal INN of a company director using only the company name or INN
- Map corporate ownership chains by traversing founder company_ids recursively
- Screen a supplier list for companies below a revenue or employee threshold
- Audit ownership changes over time using historical records from get_company_founders
- Discover affiliated or subsidiary companies by extracting links from a company's Rusprofile page
- Build a due-diligence dataset filtered to companies that filed financials for a given year
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Rusprofile.ru have an official developer API?+
What does get_company_founders return for historical ownership, and when is that data masked?+
ownership_history array where each record includes status (current or historical), name, period_from, and period_to. The site sometimes masks individual founder names; in those cases the name field is returned as null. The has_history boolean and historical_count integer indicate whether past records exist even when names are suppressed.Can I filter company searches by legal form (LLC, JSC, etc.) or industry code (OKVED)?+
search_companies endpoint supports filtering by query, address, min_revenue, min_employees, and filed_financials_2025. Legal form and OKVED filtering are not exposed. You can fork this API on Parse and revise it to add those filters if Rusprofile's search surface supports them.How does pagination work in search_companies, and what is the maximum result set?+
total count and total_pages count so you can iterate. Rusprofile imposes its own limits on how deep into results you can paginate; very large result sets may not be fully accessible beyond a certain page depth.Does the API return financial statement data such as revenue, profit, or balance sheet figures?+
search_companies endpoint accepts min_revenue as a filter input but does not return revenue figures in the response items. Detailed financial statement data (profit, assets, liabilities) is not returned by any endpoint. You can fork this API on Parse and revise it to extract financial data from individual company profile pages if those figures are publicly shown on Rusprofile.