# npm API: Get package

> Looks up a public npm package by name or npm link. Returns its latest version, weekly downloads, maintainers, links, dates and version count.

Unofficial. Not affiliated with or endorsed by npm.

- Page: https://fous.com/methods/npmjs.com/get-package
- Method: `npmjs.com/get_package`, version 1
- Website: npmjs.com
- Returns: name, latest version, description, weekly downloads, license, repository, homepage, maintainers, dates, version count, npm link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `package` | string | yes | `"@angular/core"` | The npm package name or npm package page link, for example react, @angular/core, or https://www.npmjs.com/package/react. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "package": "@angular/core"
}
```

Its output:

```json
{
  "name": "@angular/core",
  "license": "MIT",
  "homepage": "https://github.com/angular/angular#readme",
  "description": "Angular - the core framework",
  "maintainers": [
    "angular",
    "google-wombot"
  ],
  "created_date": "2016-04-28",
  "npm_page_link": "https://www.npmjs.com/package/@angular/core",
  "latest_version": "22.2.3",
  "repository_link": "https://github.com/angular/angular.git",
  "weekly_downloads": 3415695,
  "last_publish_date": "2026-10-14",
  "number_of_versions": 1124
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"npmjs.com/get_package","input":{"package":"@angular/core"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the latest version of the lodash package and how many weekly downloads does it get?
- Can you pull up the maintainers and license for @angular/core?
- Look up the npm package at https://www.npmjs.com/package/express and tell me its repository and homepage links.
- How many versions has the axios package published, and when was it last updated?
- Find the npm page for the zod package on npmjs.com and summarize its description and weekly download count.

## Input schema

```json
{
  "type": "object",
  "required": [
    "package"
  ],
  "properties": {
    "package": {
      "type": "string",
      "description": "The npm package name or npm package page link, for example react, @angular/core, or https://www.npmjs.com/package/react."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "latest_version",
    "description",
    "weekly_downloads",
    "license",
    "repository_link",
    "homepage",
    "maintainers",
    "last_publish_date",
    "created_date",
    "number_of_versions",
    "npm_page_link"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "license": {
      "type": [
        "string",
        "null"
      ]
    },
    "homepage": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "maintainers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "created_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "npm_page_link": {
      "type": "string"
    },
    "latest_version": {
      "type": [
        "string",
        "null"
      ]
    },
    "repository_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "weekly_downloads": {
      "type": [
        "integer",
        "null"
      ]
    },
    "last_publish_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "number_of_versions": {
      "type": "integer"
    }
  }
}
```

## See more

- [npm API: Get download stats](https://fous.com/methods/npmjs.com/get-download-stats.md): Returns total and daily or Monday-start weekly npm downloads for a package over the last week, month, or year.
- [npm API: Search packages](https://fous.com/methods/npmjs.com/search-packages.md): Searches the npm registry for JavaScript packages by description or keywords, in npm's search order, and returns each package's latest version, weekly downloads and publish date.
- [NuGet API: Get package](https://fous.com/methods/nuget.org/get-package.md): Looks up a NuGet package by name or nuget.org link. Inexact names match the top search result. Returns the latest stable release's details and the 10 most recent versions, including prereleases.
- [PyPI API: Get package](https://fous.com/methods/pypi.org/get-package.md): Gets a PyPI package's current version, release date, metadata, project links and its 10 most recently published versions from a package name or PyPI link.
- [RubyGems API: Get a Ruby gem's details](https://fous.com/methods/rubygems.org/get-gem.md): Looks up a Ruby gem on RubyGems by name or gem page link and returns its latest version, release date, description, downloads, authors, license, links and runtime dependencies.
- [Visual Studio Marketplace API: Get VS Code extension](https://fous.com/methods/marketplace.visualstudio.com/get-extension.md): Finds a VS Code Marketplace extension by name or marketplace link and returns its publisher, installs, rating, version, categories and update date. For a name search it picks the most-installed close match.
- [Go Packages API: Get Go module](https://fous.com/methods/pkg.go.dev/get-module.md): Looks up a Go module on pkg.go.dev by path, link or name. For a name, it uses the module of the top package search result.
- [GitHub API: Get repository facts](https://fous.com/methods/github.com/get-repository.md): Looks up a public GitHub repository by name, owner/name, or link and returns its stars, forks, release, commit and contributor facts.
- [All npm methods](https://fous.com/methods/npmjs.com.md)