rusprofile.ru APIrusprofile.ru ↗
Search Russian companies by name, INN, or OGRN. Retrieve profiles, director INN, OGRN, registration address, and hyperlinks via the Rusprofile API.
curl -X GET 'https://api.parse.bot/scraper/952cd99d-a90c-45b2-85e9-3467c387dd77/search_companies?query=%D0%A1%D0%B1%D0%B5%D1%80%D0%B1%D0%B0%D0%BD%D0%BA' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for companies by name, INN, or OGRN. Returns a paginated list of matches with basic info including name, INN, OGRN, address, and CEO name. If the search matches exactly one company, the site redirects to that profile and a single-item result is returned.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query — company name, INN, or OGRN. |
{
"type": "object",
"fields": {
"items": "array of company summaries with id, name, inn, ogrn, address, ceo_name, link",
"total": "integer total number of matching companies"
},
"sample": {
"data": {
"items": [
{
"id": "2835629",
"inn": "7707083893",
"link": "/id/2835629",
"name": "ПАОСбербанк",
"ogrn": "1027700132195",
"address": "117312, город Москва, ул. Вавилова, д.19",
"ceo_name": "Греф Герман Оскарович"
}
],
"total": 113
},
"status": "success"
}
}About the rusprofile.ru API
The Rusprofile API provides 4 endpoints for querying Russian company records from rusprofile.ru. Use search_companies to find companies by name, INN, or OGRN and get back paginated summaries including address and CEO name. Use get_company_profile or get_director_details to pull structured director information — full name, personal INN, role, and profile link — for any company identified by its Rusprofile internal ID.
Company Search and Profile Retrieval
The search_companies endpoint accepts a query parameter — a company name, INN, or OGRN — and returns a list of matches. Each item includes id, name, inn, ogrn, address, ceo_name, and a link to the Rusprofile page. The total field gives the full count of matches. When the query resolves to exactly one company, the endpoint returns a single-item array rather than a paginated list.
Director Information
get_company_profile takes a Rusprofile company_id (obtained from search results) and returns a director object containing name, inn, role, and link. The same director object is returned by get_director_details, which accepts either a company_id or a free-text query — useful when you have a company name but no internal ID. Both endpoints return the top-level company fields id, inn, name, and ogrn alongside the director data.
Link Extraction
The extract_links endpoint retrieves all hyperlinks from any Rusprofile page given a path such as /id/<company_id>. An optional section_selector CSS selector narrows extraction to a specific part of the page. Each result in the links array includes a text label and an href value. This is useful for discovering related entities, subsidiaries, or affiliated profiles linked from a company page.
Coverage Notes
All data reflects what is publicly listed on rusprofile.ru for Russian legal entities. The API surfaces INN and OGRN identifiers, registration addresses, and director personal INN numbers. Financial statements, court records, and ownership history visible on some Rusprofile pages are not currently exposed by the structured endpoints.
- Verify a Russian supplier's INN and OGRN before entering a contract.
- Bulk-look up director personal INN numbers for due diligence workflows.
- Cross-reference CEO names returned by
search_companiesagainst other databases. - Discover affiliated entities by extracting links from a company's Rusprofile page.
- Automate company identity checks using OGRN as a unique identifier.
- Feed registration addresses into geocoding pipelines for geographic analysis of Russian businesses.
- Build a watch-list that monitors director role changes across multiple companies.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does rusprofile.ru offer an official developer API?+
What does `get_director_details` return that `search_companies` does not?+
search_companies returns only a ceo_name string in each summary item. get_director_details returns a structured director object with the director's full name, personal INN, role title, and a direct link to their Rusprofile page — which is necessary for identity verification or further lookups.Does the API return financial statements or court records for Russian companies?+
Can I retrieve a list of all companies associated with a specific director INN?+
How does pagination work in `search_companies`?+
total integer indicating the full match count and an items array for the current page. If the search resolves to exactly one company (because the query matches an INN or OGRN uniquely), the site returns that single profile directly and the result is a one-item array regardless of total.