API Playground

Test the DataShows API in real-time. Generate charts or get data for external libraries.

Choose Output Format

Generate static images or get data + config for external chart libraries

Client SDK (React)

datashows-sdk/react

Use React hooks for client-side chart generation with automatic state management.

Rate Limit

Free tier: 25 generations/week. Subscribed: 500/month + $0.02 per additional generation.

Credit Cost

This endpoint costs 1 generation per successful request. Failed requests do not consume credits.

Parameters

Your DataShows API key. Get one from your account. If you are authenticated you don't need to provide it.

View data
[
  {
    "month": "Jan",
    "sales": 4200,
    "expenses": 3800
  },
  {
    "month": "Feb",
    "sales": 5100,
    "expenses": 4200
  },
  {
    "month": "Mar",
    "sales": 4800,
    "expenses": 3900
  },
  {
    "month": "Apr",
    "sales": 6200,
    "expenses": 4500
  },
  {
    "month": "May",
    "sales": 5800,
    "expenses": 4300
  },
  {
    "month": "Jun",
    "sales": 7100,
    "expenses": 4800
  }
]

Natural language description of the chart you want to create.

typescript
import { useGenerateChart } from 'datashows-sdk/react';

const generate = useGenerateChart({
  onSuccess: (result) => {
    if (result.kind === "image") {
      console.log(result.dataUrl);
    } else {
      console.log(result.data, result.config);
    }
  }
});

generate.mutate({
  data: [
  {
    "month": "Jan",
    "sales": 4200,
    "expenses": 3800
  },
  {
    "month": "Feb",
    "sales": 5100,
    "expenses": 4200
  },
  {
    "month": "Mar",
    "sales": 4800,
    "expenses": 3...,
  prompt: "Bar chart showing sales and expenses by month",
  outputFormat: "image",
  apiKey: "your-api-key"
});

Response

No chart generated yet

Configure your request and click "Try it"

💡 Quick Tips

Client SDK

Perfect for React apps. Uses hooks for state management and automatic retries.

Server SDK

Best for Node.js backends. Keeps API keys secure on the server.

API

Works with any language. Simple REST API for maximum flexibility.