OpenMercantil · Rate Limits

Openmercantil Rate Limits

Machine-readable rate limit definitions for the OpenMercantil public API. The anonymous public tier is documented at ~60 requests per minute per source IP, signaled via X-RateLimit-* headers and Retry-After on 429. Higher per-plan rate limits are alluded to in the API documentation but not enumerated publicly; values below for paid tiers are scaffold defaults and must be reconciled with the provider.

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

It captures 3 rate-limit definitions, across the free, profesional, and max tiers, measuring requests_per_minute.

The profile also includes 5 backoff/retry policies defined and response codes documented for throttled, quotaExceeded, and serviceUnavailable.

Tagged areas include Open Data, Spain, Company Data, Business Registry, and BORME.

3 Limits Throttle: 429 Quota: 429
Open DataSpainCompany DataBusiness RegistryBORMEPublic RecordsRate LimitingThrottling

Limits

Public Anonymous Tier ip
requests_per_minute · minute
60
Profesional Tier (Placeholder) account
requests_per_minute · minute
240
MAX Tier (Placeholder) account
requests_per_minute · minute
1200

Policies

Backoff Strategy
On 429 responses, clients should honor the Retry-After header and apply exponential backoff with jitter for subsequent requests.
Sliding Window
Rate limits are enforced over a sliding window per source IP on the anonymous tier. X-RateLimit-Reset signals the Unix timestamp at which the counter resets.
Fair Use
OpenMercantil is a public-interest free service. Sustained scraping or bulk-extraction patterns may be throttled even within published limits; bulk consumers should prefer the dedicated export endpoints (/api/v1/export/events, /api/v1/sectores/stats.csv) and observe ETag / cache headers.
Geocode Source Limit
The /api/v1/company/{slug}/geocode endpoint is fronted by an upstream Nominatim/OSM rate limit of approximately 1 request per second on cache misses; cache hits are unconstrained.
Anonymous Access
All public read endpoints are accessible without authentication. Only the billing endpoints (/api/v1/checkout, /api/v1/donation) require session authentication.