API Reference

The tablrr API lets you embed listings directly into your site and manage your data programmatically.

Base URL:

https://api.tablrr.app/v1

Authentication

Most endpoints require an API token in the Authorization header:

Authorization: Bearer {your-token-here}

Getting an API Token

1. Go to Settings > Sites & API Tokens in your tablrr account
2. Click "Add Site"
3. Enter your domain name
4. Verify your site and the token will be shown to you
5. Copy the token immediately - it won't be shown again

Requirements: Growth plan or higher subscription

Rate Limiting

Endpoint group	Limit
Listing, operator, site endpoints	60 req/min
Analytics read (GET views, clicks, report)	60 req/min
Analytics tracking (POST views, clicks)	2,000 req/min

Exceeding the limit returns 429 Too Many Requests. Wait a minute before retrying.

Error Format

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {}
  }
}

Code	HTTP Status	Description
RESOURCE_NOT_FOUND	404	The requested resource was not found
VALIDATION_FAILED	422	Request data is invalid or missing
FORBIDDEN	403	Access denied (plan restriction or unauthorized)
INTERNAL_ERROR	500	An internal server error occurred

Best Practices

1. Store tokens securely — never commit tokens to version control or expose them in client-side code
2. Handle errors gracefully — always check response status codes
3. Respect rate limits — implement retry logic with exponential backoff
4. Cache responses — use the ETag header for conditional requests to reduce bandwidth
5. Verify domains — ensure your domain is verified in Settings > Sites before making browser-based requests
6. Check plan requirements — Growth plan or higher is required for direct API access
7. Pass country for geo-targeted listings — detect the visitor's country server-side (e.g. from a CF-IPCountry header) and pass it as ?country=xx

Support

For API support, please get in touch.