Documentation

CardSight AI Documentation

Complete technical documentation for CardSight's AI-native trading card infrastructure. Whether you're building a mobile app with Swift or .NET, a web service with Node.js, Python, or Java, or integrating AI assistants via Model Context Protocol, our comprehensive guides, API references, and SDKs provide everything you need to ship production-ready card features in minutes.

Start with our REST API for direct HTTP integration, use type-safe SDKs for language-native development, or leverage MCP to give AI assistants like Claude conversational access to our 15M+ trading card catalog. Each path includes detailed documentation, code examples, and best practices to accelerate your integration—from proof of concept to production scale. Get your free API key and access 750 calls per month to start building today.

Getting Started

Core Documentation

Quick access to our API reference, SDKs, and AI integration guides. Everything you need to integrate CardSight into your application.

REST API
API Reference
Complete REST API documentation with examples and response schemas
AI Integration
MCP Documentation
Model Context Protocol for AI assistants like Claude
SDKs & Libraries
Official SDKs for Node.js, Python, Swift, Java & .NET, plus OpenAPI/Swagger
Interactive Demo

Try the API Playground

Experience CardSight AI in action with our interactive playground. Test every API endpoint visually and see real-time results—perfect for both developers and non-developers.

Interactive Interface

Test card identification, pricing lookups, and all API features with a user-friendly interface

Developer-Friendly

See actual API requests and responses in real-time. Copy code snippets for your projects.

All Endpoints Supported

Test every API endpoint visually — card identification, search, pricing, collections, and more.

Get Started Today

Sign up for a free account to get your API key and start exploring CardSight AI in the playground.

750 free API calls per month • No credit card required

Code Examples

Quick Example

Get started with card identification using our official SDKs. Choose your preferred language and copy the code to start building.

Identify a Card
Send an image to get card details and pricing using our SDK
NPM Package
npm install cardsightai
GitHub
import { CardSightAI, getFieldValue } from 'cardsightai';

// Initialize the client
const client = new CardSightAI({ apiKey: 'your_api_key_here' });

// Identify a card from an image
const imageFile = // File, Blob, Buffer, or ArrayBuffer
const result = await client.identify.card(imageFile);

// Access identification results
if (result.data?.success) {
  const detection = result.data.detections?.[0];
  if (detection?.card) {
    console.log(`Card: ${detection.card.name}`);
    console.log(`Confidence: ${detection.confidence}`);
    console.log(`Total cards detected: ${result.data.detections.length}`);

    // Pokemon, One Piece, and Magic detections report the printed
    // language as an ISO 639-1 code; undefined on sports cards
    console.log(getFieldValue(detection, 'CARD_LANGUAGE')); // "ja"
  }
}

// Response structure for multiple cards:
// {
//   success: true,
//   requestId: "req_xyz789",
//   detections: [
//     {
//       confidence: "High",
//       card: {
//         /* Card details */
//         fields: [{ key: "CARD_LANGUAGE", value: "ja" }]  // TCG only
//       }
//     }
//   ],
//   processingTime: 1500
// }

Prefer another language? CardSight AI is OpenAPI 3.0 / Swagger compatible—generate a typed client for any stack, or browse the full SDK guide.

Ready to Start Building?

Get your API key and start identifying cards in minutes

We use cookies to improve your experience and analyze site traffic. By clicking 'Accept', you agree to our use of cookies for analytics.