Returns the real-time status and circuit breaker state for all 9 search engines. No credits are charged for this endpoint.
This is useful for: - Checking which engines are healthy before making search requests - Monitoring engine health in production - Debugging search failures - Building dashboards for operational visibility
Jiro supports 9 search engines, each with different strengths, credit costs, and rate limits:
| Name | Type | Description |
|---|---|---|
bing | 3 credits | Microsoft Bing. Default engine. 30 RPM limit, burst: 5. Best all-around engine with good global coverage. Returns web, image, and video results. |
google | 10 credits | Google Search. Premium pricing due to higher infrastructure costs. 10 RPM limit, burst: 2. Most comprehensive results with strong localisation. Supports type parameter for images, videos, news. |
duckduckgo | 3 credits | DuckDuckGo. Privacy-focused engine. 60 RPM limit, burst: 10. Most permissive engine limits. Good for general web search. |
brave | 3 credits | Brave Search. Independent search engine. 30 RPM limit, burst: 5. Good tech and privacy-focused content. |
youtube | 3 credits | YouTube search. 20 RPM limit, burst: 3. Searches videos, channels, and playlists. Returns video titles, descriptions, and durations. |
amazon | 3 credits | Amazon product search. 10 RPM limit, burst: 2. Returns product titles, prices, ratings, and URLs. |
ebay | 3 credits | eBay product search. 15 RPM limit, burst: 3. Returns auction listings with prices and bid counts. |
yandex | 3 credits | Yandex search. 20 RPM limit, burst: 3. Best for Russian-language queries and Eastern European content. |
baidu | 3 credits | Baidu search. 10 RPM limit, burst: 2. Best for Chinese-language queries and Chinese web content. |
Each engine has its own circuit breaker that protects the system from cascading failures. The circuit breaker monitors consecutive failures and temporarily disables unhealthy engines.
CLOSED — the engine is healthy and operating normally. All requests pass through to the engine. This is the normal operating state.
OPEN — the engine has failed 5 consecutive times. All requests to this engine are immediately rejected with a 503 ENGINE_UNAVAILABLE error without hitting the upstream. The circuit stays open for 60 seconds.
HALF_OPEN — the 60-second cooldown has elapsed. One probe request is allowed through to test if the engine has recovered. If the probe succeeds, the circuit closes and normal operation resumes. If the probe fails, the circuit reopens for another 60 seconds.
This pattern prevents hammering a failing engine while allowing automatic recovery. Credits are refunded when requests are rejected due to an open circuit.
Check engine status using each SDK: