---
title: "Surfer API Rate Limits & Quotas"
description: "A quick reference for rate limits per endpoint, usage quotas per tool, and how to monitor them programmatically so your integrations don't hit unexpected walls."
url: https://docs.surferseo.com/en/articles/12944182-surfer-api-rate-limits-and-quotas
collection: "API"
updated: 2026-10-22
language: en
alternates: [fr, de]
---

# Surfer API Rate Limits & Quotas

A quick reference for rate limits per endpoint, usage quotas per tool, and how to monitor them programmatically so your integrations don't hit unexpected walls.

## ⏱ Rate limits

All endpoints enforce a **per-second or per-minute rate limit**. Exceeding it returns `429 Too Many Requests`.

<table data-id="9c3d9fb8-4785-4e64-bf60-19482f71deb6" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="ca0e9f0b-08bf-4da3-872e-9d6900b52dc0"><strong>Endpoint group</strong></p></td><td colspan="1" rowspan="1"><p data-id="a9365e93-3720-43eb-abe5-047b0f9ddfaa"><strong>Rate limit</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b6c0af42-3be2-4a84-8bd0-04dc803d5039">Most endpoints (GET + POST)</p></td><td colspan="1" rowspan="1"><p data-id="f64d0129-3f69-47a3-8bc0-3904d23e97eb">10 requests / sec</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c2a9e78b-a3b7-44c0-be1d-2ce8bb35e386">SERP Analyzer batch</p></td><td colspan="1" rowspan="1"><p data-id="5a74f36e-5be5-46e0-8e2f-b85ad3cb2049">10 requests / min</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a47b981e-e709-47c0-b395-ff2e5f90a2db">AI Detector</p></td><td colspan="1" rowspan="1"><p data-id="62c36631-ad32-4f10-a738-01250c99893a">60 requests / min</p></td></tr></tbody></table>

When you hit a 429, wait before retrying. Check the `Retry-After` header on the response to see how long to wait, then retry. Use exponential backoff for automated workflows.

#### Monitoring rate limits via response headers

Every V2 API response includes these headers so you can track limits before hitting them:

<table data-id="151d3eea-0f99-4272-89cf-e5c52011b721" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="51a6dcdc-8a33-4fb1-bd20-a95ff0ea50a9"><strong>Header</strong></p></td><td colspan="1" rowspan="1"><p data-id="b87eb122-7e2c-441f-92fa-79be69eb95f7"><strong>Type</strong></p></td><td colspan="1" rowspan="1"><p data-id="41ddbe29-239d-4863-b499-9283fd4259fe"><strong>What it tells you</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c13d1c15-4b75-42fc-b96a-f18bc62b62d3"><code>x-ratelimit-limit</code></p></td><td colspan="1" rowspan="1"><p data-id="399e44b0-99f6-4d53-a6bb-6d83af4966d8">integer</p></td><td colspan="1" rowspan="1"><p data-id="7d62b303-ed6c-4a7f-8e03-2071fdd52ec7">Max requests allowed in the current window for this endpoint</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="38c5588c-18d7-4761-8c59-9b2f45c8cfe8"><code>x-ratelimit-remaining</code></p></td><td colspan="1" rowspan="1"><p data-id="c9a63ff0-9ee3-438a-9d08-cee2efd0cd92">integer</p></td><td colspan="1" rowspan="1"><p data-id="f1c009e8-a8fe-4f46-a19d-0d3f39d31910">Requests left before you're rate-limited (<code>0</code> = next request will be blocked)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="769fd842-01ca-4a0d-a33a-453998b9c489"><code>x-ratelimit-reset</code></p></td><td colspan="1" rowspan="1"><p data-id="b36785be-49c4-4a1c-a818-4fbffcb6876f">integer</p></td><td colspan="1" rowspan="1"><p data-id="d56107b1-c8c8-4b64-b36f-f348ceea2932">Unix timestamp (seconds) when the window resets</p></td></tr></tbody></table>

Reading `x-ratelimit-remaining` in your integration lets you slow down proactively instead of waiting for a 429.

* * *

## 📊 Usage quotas

Quotas are separate from rate limits, they track how many queries you've consumed in a billing period. Limits below are per our [Fair Usage Policy](https://docs.surferseo.com/en/articles/12944161-fair-usage-policy.md) for Peace of Mind. While Enterprise limits are custom, contact your Customer Success Manager to verify your quota or check your [Usage](https://app.surferseo.com/settings/current_usage) dashboard under Settings.

<table data-id="f14b6fad-d90e-4b2c-9ea2-41452509994e" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="849a22ad-3eb7-4d72-97cc-9f2f95bab8d6"><strong>Tool</strong></p></td><td colspan="1" rowspan="1"><p data-id="939bbeae-a9a3-4733-80f8-02ff72ce266b"><strong>Quota (monthly · annual)</strong></p></td><td colspan="1" rowspan="1"><p data-id="7d97288d-a1b8-4073-9b1e-1c10ec348d0e"><strong>What happens when exceeded</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a9bc44bd-00f4-46c2-9086-f9aee48a0aac">Content Editor (Documents)</p></td><td colspan="1" rowspan="1"><p data-id="cc8d2e05-5be0-44e0-96d4-de7151d69c98">500 / month · 6,000 / year (Peace of Mind) · Custom (Enterprise)</p></td><td colspan="1" rowspan="1"><p data-id="1ef2c39d-a144-416f-94ed-9e4111d2e3fe"><code>422 Quota exceeded</code></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="7481dca7-974f-45a9-adb8-06c3f8292d84">Audit</p></td><td colspan="1" rowspan="1"><p data-id="5b30ee6d-4265-4a42-b988-16d4ae962ad5">100 / month · 1,200 / year</p></td><td colspan="1" rowspan="1"><p data-id="310af80c-512d-4430-9194-09b2973bddc9"><code>422 Quota exceeded</code></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c39935dc-698e-4136-9267-a2701bc20468">SERP Analyzer</p></td><td colspan="1" rowspan="1"><p data-id="9cb68bba-66f7-450d-a17a-2fc7e9f6f670">100 queries / day</p></td><td colspan="1" rowspan="1"><p data-id="3d7192a6-75d7-44e7-9095-d69c22f418f8"><code>422 Quota exceeded</code></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="cdc8cc18-89f5-49ef-ad67-d8e2006322c5">Auto-Optimize</p></td><td colspan="1" rowspan="1"><p data-id="a4d05f6a-2067-4c32-86c3-cb111391415b">100 / day</p></td><td colspan="1" rowspan="1"><p data-id="7c09732c-3925-409b-b6c4-0f9b1b9f9f88"><code>422 Quota exceeded</code></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a573eb32-4837-4d74-8a63-5fbf2c118a48">Humanizer &amp; AI Detector</p></td><td colspan="1" rowspan="1"><p data-id="87e9ec87-868c-4ec6-ac5c-b3862a129fd7">50,000 words / month · 600,000 words / year (all plans)</p></td><td colspan="1" rowspan="1"><p data-id="c0c5b987-6215-4f12-99ec-acf149081b00"><code>422 Quota exceeded</code></p></td></tr></tbody></table>

> **Success:** Note: There is currently no API endpoint to check remaining credits or quota usage programmatically. To avoid hitting limits mid-run, track your own [usage](https://app.surferseo.com/settings/current_usage) or check your dashboard before large batch jobs.

* * *

## **Additional resources:**

[Surfer API Introduction](https://docs.surferseo.com/en/articles/5700335-surfer-api-introduction.md)

[Surfer API Documentation (v1)](https://app.surferseo.com/api/v1/docs#section/Introduction)

[Surfer API Documentation (v2)](https://app.surferseo.com/api/v2/docs)

[Surfer API Examples of Use](https://docs.surferseo.com/en/articles/8201326-surfer-api-examples-of-use.md)
