DEVELOPER TOOLS

Get npm Package API

Fetch metadata for a public npm package: latest version, recent versions, maintainers, license, repository, keywords.

npmpackagenodejspython

How to call it

Send one POST to api.upapi.io/npm-package.get with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 1 weighted unit of your monthly quota. The operation times out after 15 seconds. Identical requests are served from cache for 300 seconds, unbilled.

endpoint

POST https://api.upapi.io/npm-package.get

Get npm Package API reference

Request parameters

name: stringrequired — Package name, including @scope/ for scoped packages (e.g. @angular/core)

Response fields

name: stringrequired
license: stringrequired
homepage: stringrequired
keywords: arrayrequired
createdAt: stringrequired
fetchedAt: stringrequired
modifiedAt: stringrequired
repository: stringrequired
description: stringrequired
maintainers: arrayrequired
versionCount: integerrequired
latestVersion: stringrequired
latestVersions: arrayrequired
latestVersions[].version: stringrequired
latestVersions[].publishedAt: stringrequired

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body

{
  "name": "@angular/core"
}

json — example response shape

{
  "name": "example",
  "license": "example",
  "homepage": "example",
  "keywords": [
    "example"
  ],
  "createdAt": "example",
  "fetchedAt": "example",
  "modifiedAt": "example",
  "repository": "example",
  "description": "example",
  "maintainers": [
    "example"
  ],
  "versionCount": 1,
  "latestVersion": "example",
  "latestVersions": [
    {
      "version": "example",
      "publishedAt": "example"
    }
  ]
}

Code snippets

cURL

curl

curl -X POST https://api.upapi.io/npm-package.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "name": "@angular/core" }'

JavaScript

javascript

const response = await fetch('https://api.upapi.io/npm-package.get', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "name": "@angular/core"
}),
});

const data = await response.json();
console.log(data);

Python

python

import requests

response = requests.post(
    'https://api.upapi.io/npm-package.get',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "name": "@angular/core"
},
)

print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "name": "@angular/core" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/npm-package.get", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}

PHP

php

<?php

$payload = json_encode([
    'name' => '@angular/core',
]);

$ch = curl_init('https://api.upapi.io/npm-package.get');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Ruby

ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/npm-package.get')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "name": "@angular/core" }.to_json

response = http.request(request)
puts JSON.parse(response.body)

Java

java

import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"name\": \"@angular/core\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/npm-package.get")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}

csharp

using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"name\": \"@angular/core\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/npm-package.get", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Get npm Package API cost per call?

Each call spends 1 weighted unit of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the Get npm Package API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are Get npm Package API responses cached?

Yes — identical requests are served from cache for 300 seconds, and a cache hit is not billed.

More Developer Tools APIs

Get PyPI Package Get GitHub Repository Get GitHub User Get GitHub User Commit Emails List GitHub Issue Comments List GitHub Repository Contributors List GitHub Repository Issues Search dev.to Articles

Browse every Developer Tools API →