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, in the API Commons Rate Limits shape.

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

Limit state is signalled in the published, retryAfter, and note response headers, and an exhausted limit returns HTTP 429.

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 Exhausted: HTTP 429 publishedretryAfternote
Transcribed from the provider's documentation on 2026-08-13 — developers.surfe.com/rate-limits.
View Source
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
POST /v2/people/enrich
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
POST /v2/people/search
results · day
200
200 results/day on the free allowance, up to 100,000 results/day with search credits enabled.
Company Enrichment Quota account
POST /v2/companies/enrich
profiles · day
2000
2,000 profiles/day free, up to 100,000/day with search credits.
Company Search Quota account
POST /v2/companies/search
results · day
200
200 results/day free, up to 100,000 results/day with search credits.
Bulk Enrichment Batch Size request
POST /v2/people/enrich
records
10000
Maximum people per request; processed asynchronously via the enrichmentID job pattern.
Search Page Size request
POST /v2/people/searchPOST /v2/companies/searchPOST /v2/recommendations/fetch
results
200
Documented maximum for the `limit` field; page onward with nextPageToken.
People Per Company request
POST /v2/people/search
results
40
`peoplePerOrganization` maximum raised from 5 to 40 on 2026-06-30 per the changelog.
Country Filter Values request
POST /v2/people/searchPOST /v2/companies/search
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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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