Skip to main content
Understanding API limitations and specifications helps you optimize performance, plan capacity, and avoid throttling. This guide covers rate limits, driver capabilities, request constraints, and best practices.

​
Overview

Nimble’s API implements tiered specifications based on:
  • Driver selection: Different drivers have different rate limits
  • Request complexity: Complex operations may have additional constraints
  • Resource usage: Fair usage policies ensure platform stability

​
Drivers

Nimble offers different drivers optimized for various use cases:
Each driver has different pricing and rate limits. Higher-tier drivers cost more per request.

​
Rate Limits

​
Default rate limits by driver

All accounts have the following default rate limits:
Need higher limits? Reach out to your CS or open a via a Support Ticket to discuss custom rate limits based on your requirements.

​
Agent generation

Custom agent generation has a separate daily limit: This limit applies across all generation methods (API, CLI, SDK, and the Agent Builder skill). It covers both new agent creation and refinement via from_agent. See Agent Creation for details.

​
Response headers

Every response includes metadata headers:
Use these headers to:
  • Monitor rate limit usage
  • Track request IDs for debugging
  • Optimize driver selection
  • Measure performance

​
Handling rate limits

When you exceed rate limits, the API returns a 429 status code:
Best practices:
  • Implement exponential backoff on 429 responses
  • Use the retry_after value to schedule next request
  • Monitor rate limit headers in responses
  • Batch requests when possible
  • Use lower-tier drivers when sufficient

​
HTTP status codes

​
Success codes

​
Client error codes

​
Server error codes

Nimble automatically retries failed requests before returning a final failure status (500)

​
Blocked Domains

The following domains are blocked across all Web APIs and Proxy services. Requests targeting these domains will be rejected.
  • *.paypal.com
  • account.sonyentertainmentnetwork.com
  • acopic.click
  • adskpak.com
  • amctheatres.com
  • andromedabee.com
  • antliabee.co.uk
  • api.groupon.com
  • api.stripe.com
  • api.tyrads.com
  • apusbee.co.uk
  • auth.api.sonyentertainmentnetwork.com
  • bellarmine.click
  • caixa.gov.br
  • callofduty.com
  • canal-plus.com
  • clubmium.com
  • clubmium.net
  • couponcabin.com
  • crunchyroll.com
  • dazn.com
  • directv.com
  • ea.com
  • epicgames.com
  • fustian.click
  • gomobile.it
  • googlecm.hit.gemius.pl
  • hbo.com
  • hitspro.net
  • honeyga.in
  • honeygain.com
  • honeygain.money
  • hotstar.com
  • iplogger.org
  • kayak.com
  • mojang.com
  • mte.gov.br
  • music-box.mobi
  • mybip.it
  • myy.io
  • native.np.ac.playstation.net
  • networkcontroller.net
  • ocmey.com
  • onevanilla.com
  • ordo.link
  • pagseguro.com
  • paypal.com
  • playstation.com
  • playstation.net
  • plex.tv
  • powerbrowsing.online
  • revenuevelocity.eu
  • roblox.com
  • runescape.com
  • seasyvendas.com
  • sky.com
  • sport4life.mobi
  • spotify.com
  • ssfcu.com
  • steamcommunity.com
  • steampowered.com
  • torrentdownloads.me
  • ttvnw.net
  • tyrads.com
  • tyrrewards.com
  • ubi.com
  • ubisoft.com
  • unrealengine.com
  • usps.com
  • valuedopinions.com
  • vrv.co
  • wellsfargo.com
  • www.ltv-mob.com
  • yogini.top
  • zelator.in