node.js Airtable API Proxy by Future Fluent

Here's a project demonstrating the basics of an Airtable API proxy using node.js and Express. Click here to see the source and remix for your own purposes.

Why does Airtable need an API Proxy?

Airtable's rate limit is five requests per second per base. Anything more than that and the API will lock down for thirty seconds. By implementing an API proxy, it's possible to cache common results for quick responses and enforce a rate limit for requests.

Additionally, an API proxy allows you to keep your API key a secret. Since all Airtable API keys allow full CRUD access, using the key in client-side JavaScript code would leave your data subject to outside tampering.

Click here for example output. Records are returned as a JSON dictionary, keyed with their Airtable record IDs. This facilitates stitching together relationship fields on the client.

Click here to see the source data.

How does it work?

Three files drive the proxy:


An API route, /api/:table/list/:page, handles requests via database-connection.js.


Simple, file-based caching.


Returns cached JSON, if it's not too stale. Use cacheInterval to adjust this.

writeCacheWithPath(path, object)

Writes a JavaScript object to JSON at the specified path, creating intermediate directories as needed.


This is the meat of the project. It uses the Airtable node.js client to connect to a base and writes the results out as a JSON response.

tableRoutes maps between API paths and the names of tables in your Airtable base.

Base ID and Airtable API key are in 🗝.env.

For more on accessing Airtable via the API, see the interactive Airtable documentation.

Rate limiting

Bottleneck handles rate limiting. The Airtable database interactions are handled using Bottleneck's wrap function.