Comic Vine SDK

A type-safe TypeScript client for the Comic Vine API with built-in caching, deduplication, and rate limiting.

Features

Type-Safe API

Full TypeScript support with detailed type definitions for all 19 Comic Vine resources. Field selection automatically narrows return types.

Adaptive Rate Limiting

Intelligent priority-based rate limiting that maximizes API utilization by dynamically allocating capacity between user and background requests.

Caching & Deduplication

Configurable caching with TTL support and automatic deduplication of concurrent identical requests. Choose from in-memory or SQLite stores.

Auto Pagination

Iterate through all results with for await...of syntax. The client automatically fetches subsequent pages as needed.

Quick Example

import ComicVine from 'comic-vine-sdk';

const client = new ComicVine({ apiKey: 'your-api-key' });

// Get a specific issue
const issue = await client.issue.retrieve(1);

// Search for characters with type-safe field selection
const characters = await client.character.list({
  fieldList: ['id', 'name', 'image'],
  filter: { name: 'Spider-Man' },
  limit: 10,
});

Next Steps

Installation

Install the SDK and optional store packages for caching and rate limiting. Install now →

Quick Start

Set up your first client and make API requests in minutes. Get started →

Migration Guide

Upgrading from @comic-vine/client? Read the v1 to v2 migration guide. Migrate →

Guides

Learn about field selection, filtering, pagination, and more. Read guides →

API Reference

Explore all 19 resources, configuration options, and error types. View reference →