scoris.lt APIscoris.lt ↗
Access Lithuanian company profiles, financial reports, salary data, and rankings via the Scoris.lt API. 6 endpoints covering search, financials, and top-company lists.
curl -X GET 'https://api.parse.bot/scraper/4666a00b-6a07-4bd2-88aa-0b2b13988071/search_companies?query=MAXIMA' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for companies by name or keyword. Returns a list of matches with IDs and basic info.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search term (e.g. company name) |
{
"type": "object",
"fields": {
"results": "array of objects with id, label, and address fields"
},
"sample": {
"data": {
"results": [
{
"id": 123033512,
"label": "MAXIMA LT, UAB",
"address": "Vilnius, Naugarduko g. 84"
}
]
},
"status": "success"
}
}About the scoris.lt API
The Scoris.lt API provides access to Lithuanian business intelligence across 6 endpoints, covering company search, financial statements, employee salary trends, and curated rankings. The get_company_financials endpoint returns multi-year financial data and VMI tax arrears history, while get_top_companies surfaces ranked lists across categories such as largest companies, most profitable, and highest average salaries.
Company Search and Profiles
The search_companies endpoint accepts a query string and returns an array of matches, each with an id, label, and address. That id (or the registration company_code) feeds into get_company_basic_info, which returns the company's registered address, VAT code, a shareholders object mapping ownership categories to counts, and an array of similar_companies with names, codes, and URLs.
Financial Data and Tax Arrears
get_company_financials takes a company_code and returns a response keyed by section title — for example, 'MAXIMA LT- Company finances' and 'MAXIMA LT- VMI tax arrears'. Each section is an array of objects mapping column headers to values, giving you multi-year balance sheet and income statement rows alongside official VMI tax debt history in a single call.
Salary and Headcount Trends
get_company_employees_salaries returns an average_salary object mapping year to salary in euros and an employee_count object mapping period labels to headcount figures. It also includes summary_stats and sections arrays that describe the data headers, making it straightforward to reconstruct the time series for a given company.
Filtering and Rankings
The filter_companies POST endpoint supports filtering by size (Stambi, Vidutinė, Smulki, Mikro), status (e.g. Veikiantis for active), and a name_part fragment. The response includes a rowsCount field for pagination planning and per-row fields such as JA_kodas, JA_pavadinimas, pvm, and scoris_reitingas. get_top_companies requires no inputs and returns a rankings object mapping category names to arrays of companies with their metric values.
- Screen Lithuanian suppliers by filtering active companies of a specific size with
filter_companiesand checking theirscoris_reitingas. - Pull multi-year revenue and tax arrears data via
get_company_financialsto assess credit risk before entering a contract. - Track average salary trends for a competitor using
get_company_employees_salariesto inform compensation benchmarking. - Build a Lithuanian company directory by combining
search_companiesresults with full profiles fromget_company_basic_info. - Identify top-performing Lithuanian companies in specific categories using
get_top_companiesfor market research or investment screening. - Monitor shareholder structure changes by periodically querying
get_company_basic_infoand diffing theshareholdersfield. - Enrich a CRM with Lithuanian company metadata by resolving company names to codes via
search_companiesand fetching VAT codes and addresses.
| 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 Scoris.lt offer an official developer API?+
What does the `filter_companies` endpoint return, and how does pagination work?+
data array of company objects with fields JA_kodas (registration code), JA_pavadinimas (name), pvm (VAT number), and scoris_reitingas (Scoris rating), plus a columns array of display names and a rowsCount integer showing the total number of matching records. Use rowsCount to determine how many pages of results exist, then adjust your filter parameters accordingly.Does the API return contact details such as phone numbers or email addresses for companies?+
get_company_basic_info returns registration details, address, VAT code, shareholders, and similar companies, but no phone or email fields. You can fork this API on Parse and revise it to add an endpoint targeting those contact data sections if Scoris.lt surfaces them.What geographic coverage does this API have?+
Does `get_company_financials` include subsidiary or consolidated financial statements?+
'MAXIMA LT- Company finances' — reflecting the data Scoris.lt presents for that registration code. Whether a given section represents consolidated or standalone figures depends on how Scoris.lt classifies the company; the API does not add a separate flag. You can fork this API on Parse and revise it to parse or label the section titles if you need to distinguish the two.