MVNRepository APImvnrepository.com ↗
Search Maven artifacts, retrieve artifact details, licenses, categories, relocation notices, and popular rankings from MVNRepository via a simple REST API.
What is the MVNRepository API?
This API exposes 3 endpoints for querying Maven artifact data from MVNRepository, covering artifact metadata, keyword search, and popularity rankings. The get_artifact endpoint returns fields including license, categories, is_relocated, relocated_to, latest_version, and latest_version_date for any artifact identified by its group and artifact ID. Use search to find artifacts by keyword with paginated results, or get_popular to retrieve the top-ranked artifacts by usage count.
curl -X GET 'https://api.parse.bot/scraper/e0f94779-1992-4a91-8ea8-a82f17840fbc/get_artifact?name=junit-jupiter-api&group=org.junit.jupiter' \ -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 mvnrepository-com-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.mvnrepository_api import MVNRepository, Artifact, ArtifactSummary, PopularArtifact
client = MVNRepository()
# Search for Maven artifacts by keyword
for summary in client.artifactsummaries.search(query="junit", limit=5):
print(summary.title, summary.group, summary.name, summary.is_relocated)
# Get full details for a specific artifact
artifact = client.artifacts.get(group="org.junit.jupiter", name="junit-jupiter-api")
print(artifact.title, artifact.license, artifact.latest_version, artifact.categories)
# Navigate from a search result to its full details
for result in client.artifactsummaries.search(query="slf4j", limit=3):
detail = result.details()
print(detail.title, detail.license, detail.latest_version_date)
# List the most popular artifacts
for popular in client.popularartifacts.list(limit=10):
print(popular.rank, popular.title, popular.group, popular.usages)
Get details for a specific Maven artifact, including its relocation status, license, categories, and latest version information. Returns the full metadata for one artifact identified by its group and name coordinates.
| Param | Type | Description |
|---|---|---|
| namerequired | string | Maven artifact ID (e.g., 'junit-jupiter-api', 'jetty'). |
| grouprequired | string | Maven group ID (e.g., 'org.junit.jupiter', 'org.mortbay.jetty'). |
{
"type": "object",
"fields": {
"name": "string — Maven artifact ID",
"group": "string — Maven group ID",
"title": "string — display title of the artifact",
"license": "string — license name",
"categories": "array of category name strings",
"description": "string — artifact description",
"is_relocated": "boolean — whether the artifact has been relocated",
"relocated_to": "object with group, name, url, full_name if relocated; null otherwise",
"latest_version": "string — latest version number",
"latest_version_date": "string — date of latest version release"
},
"sample": {
"data": {
"name": "junit-jupiter-api",
"group": "org.junit.jupiter",
"title": "JUnit Jupiter API",
"license": "EPL 2.0",
"categories": [
"Testing"
],
"description": "JUnit Jupiter is the API for writing tests using JUnit 5.",
"is_relocated": false,
"relocated_to": null,
"latest_version": "6.1.0",
"latest_version_date": "May 20, 2026"
},
"status": "success"
}
}About the MVNRepository API
Artifact Details
The get_artifact endpoint accepts two required parameters — group (e.g., org.junit.jupiter) and name (e.g., junit-jupiter-api) — and returns a structured object with the artifact's display title, description, license, categories array, latest_version, and latest_version_date. Notably, it also exposes relocation data: is_relocated is a boolean flag, and when true, relocated_to provides the replacement artifact's group, name, url, and full_name. This is useful for detecting deprecated or moved artifacts before adding them as dependencies.
Search
The search endpoint accepts a required query string and an optional page integer for pagination. Each page returns up to 10 results. Each result object includes group, name, title, description, is_relocated, relocated_to, and usages — the usage count as indexed on MVNRepository. Out-of-range page numbers return an empty results array rather than an error, so iterating pages until empty is a reliable way to exhaust results.
Popular Artifacts
The get_popular endpoint takes no inputs and returns a ranked list of artifacts by usage count. Each entry includes rank, group, name, title, description, and usages. This is useful for identifying the most widely adopted libraries in the Maven ecosystem at any point in time.
The MVNRepository API is a managed, monitored endpoint for mvnrepository.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mvnrepository.com 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 mvnrepository.com 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?+
- Detect relocated or deprecated Maven artifacts before embedding them in a build file by checking
is_relocatedandrelocated_to. - Build a dependency audit tool that resolves artifact license information using the
licensefield fromget_artifact. - Power an IDE plugin that autocompletes Maven coordinates by querying the
searchendpoint with a keyword. - Track trending Java libraries by polling
get_popularand recording theusagesandrankfields over time. - Validate that a given
group/namepair exists and retrieve itslatest_versionbefore generating a POM template. - Categorize a set of dependencies by their
categoriesarray to audit third-party library usage by domain. - Identify the most common replacements for deprecated artifacts by aggregating
relocated_todata across search results.
| 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 MVNRepository have an official developer API?+
What does the `get_artifact` endpoint return for relocated artifacts?+
is_relocated is set to true and relocated_to contains an object with the replacement artifact's group, name, url, and full_name. For non-relocated artifacts, relocated_to is null.Does the `search` endpoint return all available versions for each artifact?+
search results include only top-level artifact metadata — group, name, title, description, is_relocated, relocated_to, and usages — not a list of versions. Version details are available via get_artifact, which exposes latest_version and latest_version_date but not a full version history. You can fork this API on Parse and revise it to add a version-listing endpoint.Is there a limit to how many pages the `search` endpoint supports?+
results array rather than an error. There is no explicit total_results or total_pages field in the response, so callers must paginate until an empty page is returned.Does the API expose download counts or vulnerability data for artifacts?+
usages field in search and popular results), license names, categories, and relocation status, but does not include download statistics or security/vulnerability information. You can fork this API on Parse and revise it to add endpoints targeting those data points.