🎮 Interactive Live Sandbox
Test search queries, toggle National Dress / Cultural attire across 60 cultures, tweak skin & hair colors, and inspect generated code in real time.
run (Correr / يركض)
curl "https://fleximbols.pages.dev/api/v1/svg/stick/People/Actions/run.svg"📡 REST API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/search | Search symbols across 78 languages with category, style, gender, and adult filtering. |
| GET | /api/v1/disambiguate | Resolves polysemic English words (e.g. board, bat, scale) into domain-accurate localized descriptions. |
| GET | /api/v1/categories | Returns the 143 category taxonomy with localized labels in the requested language. |
| GET | /api/v1/languages | Returns list of all 78 supported languages with native names, flags, and text directions. |
| GET | /api/v1/svg/{style}/{category}/{symbol} | Dynamic SVG generator with 60 National Dress styles, skin, hair, border, and CVI transforms. |
| GET | /api/v1/stats | Library statistics, symbol counts, and version metadata. |
| GET | /api/v1/openapi.json | OpenAPI 3.1 specification for code generation. |
⏱ Rate Limiting & Performance
The Fleximbols API is free, publicly accessible, and requires no API key registration. To ensure high availability and prevent DDoS scraping, requests are regulated by a token bucket algorithm:
- Sustained Rate: 60 requests per minute (~1 request/second average per client IP).
- Burst Capacity: Up to 20 requests in an immediate burst (allowing communication board grids to load instantaneously).
- HTTP 429 Status: Returns standard
Retry-After: 1header if burst limits are exceeded. - CORS:
Access-Control-Allow-Origin: *enabled globally. - Global Edge Caching: Transformed SVGs are cached on Cloudflare's global edge network for fast worldwide delivery.