# metascraper

> Scrape metadata from any URL using Open Graph, JSON-LD, HTML meta tags, and smart fallbacks.

Latest version **5.58.1** (published 2026-09-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install metascraper
pnpm add metascraper
yarn add metascraper
bun add metascraper
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 5.58.1 |
| Published | 2026-09-17 |
| First published | 2016-05-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >= 22 |
| Dependencies | 4 |
| Unpacked size | 12.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | ianstormtaylor, kikobeats, mahnuh, nphahn |
| Keywords | article, cheerio, extract, html, json-ld, metadata, metascraper, og, open-graph, preview, scraper, unfurl |

## Links

- npm: https://www.npmjs.com/package/metascraper
- Repository: https://github.com/microlinkhq/metascraper
- Homepage: https://metascraper.js.org
- Issues: https://github.com/microlinkhq/metascraper/issues
- npm.io page: https://npm.io/package/metascraper

## Dependencies (4)

- [whoops](https://npm.io/package/whoops.md) ~5.1.2
- [cheerio](https://npm.io/package/cheerio.md) ~1.2.0
- [debug-logfmt](https://npm.io/package/debug-logfmt.md) ~1.4.12
- [@metascraper/helpers](https://npm.io/package/@metascraper/helpers.md) 5.56.2

## Alternatives

- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads

## Recent versions

- 5.58.1 (latest) — 2026-09-17
- 3.0.0-alpha.3ac8a881 (canary) — 2017-12-15
- 5.56.2 — 2026-08-17
- 5.56.1 — 2026-08-17
- 5.55.2 — 2026-08-13
- 5.55.1 — 2026-08-10
- 5.55.0 — 2026-08-09
- 5.54.1 — 2026-08-07
- 5.54.0 — 2026-08-07
- 5.53.0 — 2026-07-30
- 5.52.1 — 2026-07-29
- 5.52.0 — 2026-07-29
- 5.51.1 — 2026-06-19
- 5.50.6 — 2026-06-09
- 5.50.5 — 2026-06-09
- … 356 more at https://npm.io/package/metascraper/versions

## README

<div align="center">
  <br>
  <img style="width: 500px; margin:3rem 0 1.5rem;" src="https://metascraper.js.org/static/logo-banner.png" alt="metascraper">
  <br>
  <br>
  <p align="center" style="width: 500px"><strong>metascraper</strong>: A library to easily scrape metadata from an article on the web using Open Graph metadata, regular HTML metadata, and series of fallbacks.</p>
  <p align="center">See our <a href="https://metascraper.js.org" target='_blank' rel='noopener noreferrer'>website</a> for more information.</p>
  <br>
</div>

## Install

```bash
$ npm install metascraper --save
```

## License

**metascraper** © [microlink.io](https://microlink.io), released under the [MIT](https://github.com/microlinkhq/metascraper/blob/master/LICENSE.md) License.<br>
Authored and maintained by microlink.io with help from [contributors](https://github.com/microlinkhq/metascraper/contributors).

> [microlink.io](https://microlink.io) · GitHub [microlinkhq](https://github.com/microlinkhq) · X [@microlinkhq](https://x.com/microlinkhq)

---
_Source: https://npm.io/package/metascraper · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._