Send a job ad. Get back a structured read of what the role really asks for: true seniority, the capability mix, how inflated the requirements are, and the engagement type. Built for job boards, ATS and hiring agents that want calibrated, skills-based reads of roles. It reads roles, never people.
1. Your key
Every request carries your key in the header x-reloop-key. Sandbox keys (rl_sandbox_…) return sample reads instantly and cost nothing. Live keys are issued by hand. Write to hello@reloop.me.
2. Submit a job ad
curl -X POST https://api.reloop.me/role-intel/v1/reads \
-H "x-reloop-key: YOUR_KEY" \
-H "content-type: application/json" \
-d '{"jd_text": "…full job ad text…", "location": "Bucharest", "client_ref": "your-job-id-123"}'
Response 202: {"read_id":"rr_…","status":"processing","poll_url":"…"}
| Field | Required | Notes |
|---|---|---|
jd_text | yes | The full ad, 200–20,000 characters. Email addresses and phone numbers are removed before storage. |
location | no | City or country. The engine detects it if missing. |
client_ref | no | Your own ID, returned with the read. |
callback_url | no | An https URL. We POST {read_id,status} when the read is done. |
3. Get the read
curl "https://api.reloop.me/role-intel/v1/reads?read_id=rr_…" -H "x-reloop-key: YOUR_KEY"
Status moves from processing to delivered, usually in 5–8 minutes. Poll every 60 seconds or use a callback. During a pilot, the first reads can show held (review queue) until a person at ReLoop.me has checked them, usually within one working day.
4. What you get
true_seniority | The level the scope supports (Emerging → Executive), the gap with the stated title, and why. |
capability_mix | The capabilities the role demands, weighted primary / secondary / supporting, each with evidence from the ad. |
jd_inflation_index | none / low / medium / high, with the signals behind it. |
scope, engagement_type | Decision rights, accountable surface, and employment / contract / fractional / board. |
operating_style | How the role is set up to work, on up to 10 axes from −1 to +1: execution ↔ strategy, maintain ↔ build, specialist ↔ generalist, direct authority ↔ matrix influence, clear ↔ ambiguous scope, local ↔ international, senior IC ↔ people manager, technical depth ↔ translation. Two axes are marked ad_signal (candidate-friendly ↔ employer-risky, pay transparent ↔ opaque) because they read the ad, not the work. Neither end is better. |
ai_exposure | How much the role works with AI (e.g. User, Builder), with one line on what that means here. |
operating_stage | The stage of the function or company the role sits in (founding, scaling, steady state). |
market | The resolved location band (e.g. RO_iasi) and whether it was stated or inferred. |
links, full_read_includes | Links to ReLoop.me pages you can show next to the read, and the names of the sections only the full Role Intel read carries. |
engine | The engine versions that produced the read. Calibration is versioned. |
Reads are automated and AI-generated (EU AI Act Art. 50), calibrated estimates, not legal advice. The employer is referred to as "the employer". Outputs may not be used to screen, rank or reject candidates. Please credit "Role-Demand Brief by ReLoop.me" when you show a read to your users.
The full read
The API returns the structured core of a read. The full Role Intel read of the same ad adds: profiles that match and where the role transfers; how the ad lands with candidates and with screeners; transferability by industry, function, seniority and geography; calibration questions; pay scenarios and comp structure; and positioning lines for a CV. See the Role Intel sample.
More from ReLoop.me
| Role Intel | The full read of one job ad, for a candidate or a hiring team. |
| Profile Intel | The same capability lens applied to a CV: what a profile really shows, where it transfers, and its market value. Useful to point candidates to from a job page. |
| For hiring teams | Pilots for EU pay transparency and skills-based hiring. |
| Methodology | How reads are calibrated, and what the engine will not do. |
| How to read a job ad · EU pay transparency · Glossary | Free guides you can link from your site. |
Errors
401 key unknown or inactive · 402 balance too low · 413 ad too long · 422 ad missing or too short · 429 daily limit reached.