The Jobero Agent API lets autonomous agents and integrations run the same curated job search as the website: upload a CV and preferences, receive up to seven matched roles with tailored application documents. Results are polled from the API; tailored CV and cover letter PDFs are emailed to the account email.
Searches are paid only. There are no free runs. Every search consumes exactly one paid credit. Credits are bought via Stripe Checkout or x402 and do not expire. Registration grants zero credits.
x402 supported. Agents that can sign x402 payments may pay per call in USDC instead of using Stripe: the 402 carries a challenge in the PAYMENT-REQUIRED header (v2) and in the response body (v1). Retry with PAYMENT-SIGNATURE and credits are added on settlement. Currently settling on Base Sepolia testnet while support is in preview.
Credit packs
| Pack | Searches | Price | x402 (USDC) |
|---|---|---|---|
| pack1 | 1 | EUR 9.99 | 11.50 |
| pack3 Best value | 3 | EUR 24.99 | 28.75 |
pack3 is the recommended default (~EUR 8.33 per search vs EUR 29.97 for three singles). Only one search may run at a time; poll the active run until it finishes before starting another.
Quick start (curl)
Replace placeholders. Store api_key once — it is not shown again.
# 1. Register (0 credits)
curl -X POST https://jobero.ai/api/v1/register \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","name":"My Agent"}'
# 2. Buy credits (defaults to pack3)
curl -X POST https://jobero.ai/api/v1/checkout \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{"pack":"pack3"}'
# Open checkout_url in a browser for the human to pay.
# 3. Poll until credits_available > 0
curl https://jobero.ai/api/v1/checkout \
-H "Authorization: Bearer $API_KEY"
# 4. Start a search (one credit; cfg_email must match registration email)
curl -X POST https://jobero.ai/api/v1/searches \
-H "Authorization: Bearer $API_KEY" \
-H 'Idempotency-Key: my-run-1' \
-F 'profile={"cfg_name":"Jane Doe","cfg_email":"[email protected]","cfg_location":"Berlin, Germany","cfg_location_preference":"Fully remote EU","cfg_work_style":"remote_only","cfg_want_remote_eu":"yes","cfg_want_remote_uk":"no","cfg_want_usa":"no","cfg_languages":["english"],"cfg_seniority":"mid","cfg_industries":"technology"}' \
-F '[email protected]'
# 5. Poll until run.terminal is true; read matches
curl "https://jobero.ai/api/v1/searches?run_id=$RUN_ID" \
-H "Authorization: Bearer $API_KEY"Tailored CV and cover letter PDFs are emailed to the registered address. Document downloads over the API are not available yet.
Documentation
- auth.md — full agent protocol
- openapi.json — OpenAPI 3.1 spec
- jobero-paid-search skill — agent skill file