# contentful/contentful.js

JavaScript library for Contentful's Delivery API (node & browser)

Repository: https://github.com/contentful/contentful.js
Canonical: https://ross.abutalabs.com/products/contentfuljs
Homepage: https://contentful.github.io/contentful.js
Language: TypeScript
License: MIT
License Family: permissive
Topics: delivery-api, javascript, sdk, contentful-js-sdk, contentful
Last push: 2026-08-17T09:27:16+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 98, release rhythm 84, longevity 100
- inputs: {"age_days": 4824, "days_push": 16, "days_rel": 27, "gap_med": 4.0, "n_releases_24m": 109}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1296, forks 211 (observed 2026-08-28T04:04:16.614094+00:00)

## What it is
The official JavaScript/TypeScript SDK for Contentful's Content Delivery and Preview APIs, letting applications fetch structured content from Contentful's headless CMS. It runs in both Node.js and browsers and ships typed models for entries, assets, and content types.

## Use cases
- fetch content from contentful in a javascript app
- query entries from a headless cms api
- render contentful blog posts in a next.js site
- get assets and images from content delivery api
- use contentful preview api for draft content
- typed contentful client for typescript

## When to choose
- you build JavaScript or TypeScript apps that read content from Contentful
- you need both Delivery and Preview API access in Node or the browser
- you want an official, well-maintained SDK with TypeScript types

## When to avoid
- you need to write or manage content (use the Management API SDK instead)
- your CMS is not Contentful
- you use a non-JavaScript stack

## Facets
- artifact type: library
- maturity: stable
- function: http-client, sdk, api-framework
- domain: web-development, cms, apis, frontend, backend
- platform: browser, cross-platform
- tags: contentful, headless-cms, content-delivery-api, content-preview-api, typescript, esm, nodejs, javascript

## Member repositories
- contentful/contentful.js (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:16.614094+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-30T04:53:56.753257+00:00, confidence not recorded.
  - readme: https://github.com/contentful/contentful.js (fetched 2026-08-28T04:04:16.614094+00:00, sha fa6b031fadcf)
  - homepage: https://contentful.github.io/contentful.js (fetched 2026-08-29T12:10:46.040143+00:00, sha 71491e968e46)
- Data as of 2026-08-30T08:39:29.467469+00:00.