# forwardemail/superagent

Ajax for Node.js and browsers (JS HTTP client). Maintained for @forwardemail, @ladjs, @spamscanner, @breejs, @cabinjs, and @lassjs.

Repository: https://github.com/forwardemail/superagent
Canonical: https://ross.abutalabs.com/products/superagent
Homepage: https://forwardemail.github.io/superagent/
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2026-01-06T07:45:06+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 61, release rhythm 53, longevity 100
- inputs: {"age_days": 5622, "days_push": 239, "days_rel": 239, "gap_med": 63, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 16641, forks 1319 (observed 2026-08-28T04:11:16.882923+00:00)

## What it is
SuperAgent is a small, progressive HTTP request library for Node.js and browsers with an elegant, chainable API supporting callbacks, promises, and async/await. It provides high-level HTTP client features like JSON body serialization, header management, and plugin support in a lightweight (~50 KB gzipped) package.

## Use cases
- make ajax requests from the browser
- call rest apis from node.js
- send  post requests with headers
- http client with promise and async/await support
- make requests to unix domain sockets
- lightweight fetch alternative for javascript

## When to choose
- you want a mature, battle-tested HTTP client with a readable chainable API
- you need the same request code to work in both Node.js and the browser
- you prefer callbacks, promises, or async/await flexibility in one library

## When to avoid
- you only target modern browsers and prefer the native fetch API
- you need advanced features like interceptors or streaming that other clients like axios or got handle differently
- you are starting a new project where native fetch suffices

## Facets
- artifact type: library
- maturity: stable
- function: http-client
- domain: web-development, apis, developer-tools
- platform: browser, cross-platform
- tags: ajax, http-requests, promise-based, javascript, nodejs

## Member repositories
- forwardemail/superagent (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:16.882923+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:04:49.905508+00:00, confidence not recorded.
  - readme: https://github.com/forwardemail/superagent (fetched 2026-08-28T04:11:16.882923+00:00, sha ba46dda23c01)
  - homepage: https://forwardemail.github.io/superagent/ (fetched 2026-08-29T08:02:18.418170+00:00, sha 09b07813c76c)
- Data as of 2026-08-30T08:39:29.467469+00:00.