Back to Docs
Tutorial 1

Welcome to the Carto-Art developer API. This tutorial walks you from a fresh account to your first generated poster.

Prerequisites

  • A Carto-Art account (free tier works for the examples below)
  • Node.js 18 or later
  • An API key from your developer dashboard

Install the SDK

npm install @kkingsbe/cartoart

Generate your first poster

import { CartoArtClient } from '@kkingsbe/cartoart';

const client = new CartoArtClient({
  apiKey: process.env.CARTO_ART_API_KEY!,
});

const poster = await client.posters.generate({
  location: { lat: 34.0522, lng: -118.2437 },
  style: 'minimal',
  options: { high_res: true },
});

console.log('Poster ready:', poster.download_url);

What to read next