Updated on 2026-05-12 NovaDataHub Engineering
Developer docs

Rate Limits

NovaDataHub rate limits and quotas depend on the active plan and service. Applications should expect plan-aware enforcement and handle throttling gracefully.

Key points

  • Rate limits are enforced per service key.
  • Quota limits depend on the purchased plan.
  • Applications should use retries and backoff when rate-limited.

Common errors

  • 429 rate_limited
  • 402 quota_exceeded
Reference details

Parameters, response shape, and operational notes

Parameter notes

  • Think about both per-minute rate limits and longer-period quota ceilings.
  • High-concurrency jobs should spread requests rather than burst unnecessarily.
  • Different services may justify different worker counts depending on the workflow.

Response highlights

  • 429 errors indicate short-term throttling pressure.
  • 402 quota-exceeded behavior usually points to a longer-duration usage cap.
  • Rate-limit handling should be visible in logs, jobs, and operator dashboards.

Operational notes

  • Use exponential backoff or queued retries instead of tight retry loops.
  • Track usage trends so you can adjust plans before hard ceilings interrupt workflows.
  • Separate user-triggered requests from scheduled batch traffic where possible.

Implementation checklist

  • Decide how your app should behave when throttled versus when quota is exhausted.
  • Measure worker concurrency against plan limits before scaling jobs up.
  • Expose reset timing or quota state in internal monitoring when possible.
Code examples

Visible integration examples

curl

curl -i -H "x-api-key: YOUR_API_KEY" "https://novadatahub.com/search?q=rate+limits&sync=true"

Python

import requests
resp = requests.get('https://novadatahub.com/search', params={'q': 'rate limits', 'sync': 'true'}, headers={'x-api-key': 'YOUR_API_KEY'})
print(resp.status_code)

C# HttpClient

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var resp = await http.GetAsync("https://novadatahub.com/search?q=rate+limits&sync=true");
Console.WriteLine((int)resp.StatusCode);

Sample JSON response

{
  "ok": false,
  "error": "rate_limited",
  "resetsAt": "2026-05-11T12:00:00Z"
}
Related resources

Move from reference docs into the next relevant workflow

Rate-limit handling

Read the queueing, retry, and backoff guide for calmer handling of 429 responses in recurring jobs.

Open guide

Quota exceeded handling

Separate exhausted-plan behavior from retry logic so operator actions and user messaging stay clearer.

Open guide

Async job polling strategy

Use the async workflow guide when timeouts and intermediate states need different handling than hard failures.

Open guide

Google SERP API docs

Review a concrete endpoint that returns auth, quota, rate-limit, and timeout responses in a developer-friendly JSON format.

Open docs
Related links

Continue with connected pages

Rate-limit handling guide

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Quota exceeded guide

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Async job polling guide

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Error reference

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.