Simple tools interface with the cartodb APIs.

No longer supporting as we have moved to using cartodb-nodejs at and
Last updated 4 years ago by nmccready .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install cartodb-api 
SYNC missed versions from official npm registry.




  • Master: Build Status

The main reason this library exists is because the cartodb version only seems to handle files and urls. While this library was written to handle streaming of whatever. Also this library is promised based as well.



To interface with the Cartodb Import API

cartodb-upload --f=someGeoJSON.json --k={YOUR_API_KEY} --a={YOUR_ACCOUNT}

or streaming


  • As of right now only basic imports are supported. Synchronization may be implemented later.
  • Currently using upload with the sql api is sufficient for our needs.

cat someGeoJSON.json | cartodb-upload --k={YOUR_API_KEY} --a={YOUR_ACCOUNT}


To interface with the Cartodb Sql API

cartodb-sql --s="select count(*) from parcels;" --k={YOUR_API_KEY} --a={YOUR_ACCOUNT}

To see additional options and arguments see each relative ./cli/*.coffee file.


  • better readme with cli and library options
  • to support missing APIS:
  • Map (anonymous maps):
  • status (to get layergroupid)
  • update / insert map
  • Import:
    • status


Contributions to this project are welcome; please create an issue ticket for bugs or feature requests, and submit a PR if you have made improvements. Feature requests submitted without a quality PR may not be implemented quickly.

Current Tags

  • 0.0.7                                ...           latest (4 years ago)

4 Versions

  • 0.0.7 [deprecated]           ...           4 years ago
  • 0.0.6 [deprecated]           ...           4 years ago
  • 0.0.5 [deprecated]           ...           4 years ago
  • 0.0.4 [deprecated]           ...           5 years ago
Maintainers (2)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (14)
Dev Dependencies (0)
Dependents (0)

Copyright 2014 - 2016 © |