Scoris 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.
What is the Scoris 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.
curl -X GET 'https://api.parse.bot/scraper/4666a00b-6a07-4bd2-88aa-0b2b13988071/search_companies?query=MAXIMA' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace scoris-lt-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.scoris_lithuanian_company_database_api import Scoris, CompanySize, CompanyNotFound
scoris = Scoris()
# Search for companies by name
for summary in scoris.companysummaries.search(query="MAXIMA"):
print(summary.id, summary.label, summary.address)
# Get detailed company info by code
company = scoris.companies.get(company_code="123033512")
print(company.name, company.vat_code, company.address)
# Navigate from summary to full detail
detail = summary.details()
print(detail.full_title, detail.shareholders)
# Access financials for a company
report = company.financials()
print(report.sections)
# Access salary info
salary = company.employees_salaries()
print(salary.employee_count, salary.average_salary)
# Filter companies by size using the enum
for fc in scoris.filteredcompanies.filter(size=CompanySize.STAMBI):
print(fc.code, fc.name, fc.rating)
# Get top rankings
ranking = scoris.rankings.get()
print(ranking.rankings)
Search for Lithuanian companies by name or keyword. Returns up to 10 matching results with company IDs, names, VAT codes, and addresses. The search is fuzzy and matches partial names. Each result's id field serves as the company_code for other endpoints.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search term (e.g. company name or keyword) |
{
"type": "object",
"fields": {
"results": "array of company match objects with id, label, value, vat, and address fields"
},
"sample": {
"data": {
"results": [
{
"id": 123033512,
"vat": "LT230335113",
"label": "MAXIMA LT, UAB",
"value": 123033512,
"address": "Vilnius, Naugarduko g. 84, LT-03160"
}
]
},
"status": "success"
}
}About the Scoris API
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.
The Scoris API is a managed, monitored endpoint for scoris.lt — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when scoris.lt 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 scoris.lt 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?+
- 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 | 100 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.