Radar developer experience
Query normalized, evidence-backed, current opportunity intelligence, then move the same stable V1 schema into your own product or workflow.
Base URL
https://api.revenirdata.com
Authentication
X-API-Key · account-issued
Pagination
Signed cursor
Contract
OpenAPI · V1
Interactive API explorer
Query live persisted Radar data. Preview requests return up to 5 opportunities; create an account for full API access.
/v1/preview/opportunities01
Loading the versioned occupational taxonomy…
02
curl --request GET 'https://api.revenirdata.com/v1/preview/opportunities?job_family=data&liveness_status=live&limit=5'This keyless example queries up to 5 live opportunities from Radar's persisted data. Sign in to paginate and obtain an API key for your own integration.
GET /v1/preview/opportunities?job_family=data&liveness_status=live&limit=503
Ready to execute
Send a request to see the real status, latency, results, and JSON.
Integration contract
Radar serves already-computed, persisted intelligence. API reads never trigger discovery, crawling, ingestion, or model work.
Create API keys in your Radar account, then send the key in X-API-Key. Send a new X-Request-ID with every metered request. Radar returns that ID; reusing one can return 409 duplicate_request_id. Use GET /v1/opportunities/count to count a filtered result set without consuming opportunity quota.
Read pagination.next_cursor from the response and send it back unchanged with the same filters. Cursors are query-specific—do not modify or construct them.
Authenticated limits are account/key aware. Normal access supports pages up to 100, but the effective account maximum may be lower. Read X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. On 429, wait for Retry-After. Restricted accounts may receive lower effective limits.
An opportunity counts once when Radar first delivers its canonical ID to your account during the current plan period. Repeated retrieval in that period is free. Read X-Radar-Plan, X-Radar-Opportunity-Used, X-Radar-Opportunity-Remaining, and X-Radar-Period-End. Count requests, zero-result searches, and errors consume no opportunity quota.
Errors
Error bodies use error.code, error.message, and error.request_id. Historical accounts may also receive legacy entitlement or quota errors documented in OpenAPI.
400invalid_filter · malformed_cursor · page_size_exceededCorrect the filters, cursor, or page size.
401missing_api_key · invalid_api_key · revoked_api_keyCreate or replace the key in your Radar account.
402plan_quota_exhausted · insufficient_balanceUpgrade, wait for the next period, or fund a legacy wallet.
403api_access_disabled · api_access_suspendedUse the account page or contact Revenir.
404opportunity_not_foundThe canonical opportunity is unavailable.
409duplicate_request_idGenerate a new X-Request-ID for a new billable request.
422validation_errorCorrect parameter types or formats.
429rate_limit_exceededWait according to Retry-After and rate-limit headers.
503metering_unavailableRetry later with a new request ID.
Build with Radar
Radar is meant to be used as infrastructure. Plug it into an internal tool, developer tool, job-search workflow, niche job board, personal project, application, or related software product instead of rebuilding the acquisition and normalization layer yourself.
Building with Radar? Tell Revenir what you're using it for.
Acceptable use
Ordinary plan access does not authorize systematic reconstruction of the full Radar dataset, a competing mirror, bulk republication or resale of substantially equivalent raw data, a substantially equivalent proxy API or feed, or bypassing technical controls. Abusive automated access may be throttled, temporarily restricted, or suspended.
For unusually high volume, redistribution, licensing, or unusual access patterns, contact Revenir.