Surfe · Rate Limits

Surfe Rate Limits

Surfe enforces two independent ceilings. A request-rate limiter caps every account at 10 requests per second with short bursts to 20, resetting every minute and returning HTTP 429. Separately, per-endpoint DAILY QUOTAS cap how much data an account can pull — 2,000 profiles/day for enrichment and 200 results/day for search on the free allowance, rising to as much as 100,000/day once search credits are enabled — and those reset at midnight in the account's local time. Credits are a third, orthogonal meter: email, mobile and search pools are consumed per unit of work and exhausting one ends the request regardless of how much rate budget remains.

Surfe Rate Limits is the machine-readable rate-limit profile for Surfe on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 10 rate-limit definitions, measuring requests, profiles, results, records, and values.

The profile also includes 5 backoff/retry policies defined and response codes documented for throttled, throttledBody, quotaOrCreditsExhausted, quotaOrCreditsExhaustedAlternate, and quotaNote.

Tagged areas include B2B Data, Contact Data, Enrichment, Rate Limiting, and Quotas.

10 Limits Throttle: 429
B2B DataContact DataEnrichmentRate LimitingQuotasThrottling

Limits

Requests Per Second account
requests · second
10
Documented maximum sustained rate per user across the account's API key.
Burst account
requests · burst
20
"A burst of up to 20 requests within a short period will be allowed." The limiter is documented as resetting every minute.
People Enrichment Quota account
profiles · day
2000
Free allowance. Resets at midnight in the user's local time. No search-credit uplift is published for this quota.
People Search Quota account
results · day
200
200 results/day on the free allowance, up to 100,000 results/day with search credits enabled.
Company Enrichment Quota account
profiles · day
2000
2,000 profiles/day free, up to 100,000/day with search credits.
Company Search Quota account
results · day
200
200 results/day free, up to 100,000 results/day with search credits.
Bulk Enrichment Batch Size request
records
10000
Maximum people per request; processed asynchronously via the enrichmentID job pattern.
Search Page Size request
results
200
Documented maximum for the `limit` field; page onward with nextPageToken.
People Per Company request
results
40
`peoplePerOrganization` maximum raised from 5 to 40 on 2026-06-30 per the changelog.
Country Filter Values request
values
250
Raised from 100 to 250 on 2026-06-19.

Policies

Credit Pools
Email finder, mobile finder and search credits are metered in three separate pools. Exhausting one ends the request independently of rate limiting. Balance is readable at GET /v2/credits.
Search Credit Formula
Search consumption changed on 2026-06-09 from ceil(results / 25) to ceil(results / 10) — a 2.5x increase per call. Any cost model built before that date is wrong.
Backoff Strategy
Because no Retry-After or RateLimit-* header is returned, clients must use a fixed exponential backoff with jitter on 429 rather than reading a hint from the response.
Async Consumption
Prefer webhooks (notificationOptions.webhookUrl) over polling for bulk enrichment jobs — every poll consumes the same daily quota as the work itself.
No Idempotency
No idempotency key is documented, so a retried enrichment or search can be charged twice. Deduplicate inputs and persist the enrichmentID from the 202 before retrying anything.

Sources

Work with this as data

Every rate limit here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for rate limits

4 MCP tools reach this
  • find_rate_limitsBrowse and filter every rate limit in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This rate limit 
curl "https://apis.io/api/v1/rate-limits/surfe-rate-limits"
All rate limits 
curl "https://apis.io/api/v1/rate-limits?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.