Usage Limiting

Polygon and Polyline Limiting

Timeline API:

  • Polygon - 400 square km and no more than 70km per segment.
  • Polyline - 70 km long.
  • Max number of vertices - 550.

Historical API:

  • Polygon - 10,000 square km and no more than 70km per segment.
  • Polyline - 2,000 km long.
  • Max number of vertices - 550.

We can surface API calls, but if you are interested in gauging the number of pixels, please reach out to your account team. For Polygon - the number of API calls would be calculated per the number of pixel contained in every API call. For example if polygon size 100 pixel, every historical API call to a polygon size 100 pixel, at 100 API calls.

Rate Limiting

According to your plan, you are limited to a certain amount of requests per hour and day to any of the API endpoints. You can check the returned HTTP headers to see get your current rate limit status.

When surpassing your rate-limiting you will get a response with a 429 error code.

HeadersDescription
X-RateLimit-Limit-second
X-RateLimit-Limit-day
X-RateLimit-Limit-hour
The maximum number of requests that the API key is permitted to make per second/day/hour.
X-RateLimit-Remaining-second
X-RateLimit-Remaining-day
X-RateLimit-Remaining-hour
The number of requests remaining in the current rate limit window.

*If you need a higher rate limit, please reach out to [email protected].