Skip to main content

Documentation Index

Fetch the complete documentation index at: https://jobo.world/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Credit System

**1,000 credits = 1.00∗∗—Topupanywherefrom1.00** — Top up anywhere from 5 to $10,000 in the dashboard. Credits never expire.
Credits are the universal currency for metered API calls. You purchase credits in advance, and each API request atomically deducts the appropriate amount from your wallet. There are no monthly minimums, no overages, and no surprises — you only pay for what you use.

​
Metered Endpoints

These endpoints consume credits from your wallet:

Jobs Search

1 credit per delivered job ($1/1,000 jobs)Full-text and advanced search across millions of job listings. Per-unit metered — paginated requests that return fewer jobs than page_size only pay for what was delivered.GET /api/jobs + POST /api/jobs/search + GET /api/companies/{id}/jobs

Jobs Feed

0.5 credit per delivered job ($0.50/1,000 jobs)High-volume cursor-paginated stream of full job objects. Per-unit metered. Free with a Jobs Feed subscription.POST /api/jobs/feed

Geocode

1 credit per request ($1/1,000 lookups)Convert raw location strings into structured city/state/country with coordinates. Flat-rate — charged once per request.GET /api/locations/geocode
Per-unit vs flat-rate: Search, Feed, and the Companies list-jobs endpoint do a balance precheck against the worst-case batch size, then debit the actual cost after the response is built. Geocode debits a flat amount up-front. Either way, no credits are deducted on 4xx / 5xx responses.

​
Free Endpoints

These endpoints don’t consume credits:
EndpointNotes
GET /api/jobs/expiredAlways free — designed to keep your inventory clean. 7-day lookback per request.
POST /api/jobs/feed (with Jobs Feed subscription)Per-job pricing waived for subscription holders.
GET /api/companies/{id}Company profile lookup.
If your primary use case is bulk data ingestion (e.g., syncing your own job board), the Jobs Feed subscription is by far the most cost-effective option since per-job charges are waived entirely.

​
Currently Unavailable

EndpointStatus
/api/auto-apply/*Temporarily disabled — every request returns 503 Service Unavailable. Historical price was 200 credits per session ($0.20).

​
Request Flow

Every metered API request goes through a 4-step pipeline before a response is returned:
1

Authenticate

The API validates your X-Api-Key header. If the key is missing or invalid, you receive 401 Unauthorized immediately and no further processing occurs.
2

Rate Limit Check

Your request is checked against per-minute, per-hour, and per-day rate limits for your plan tier. If any window is exhausted, you receive 429 Too Many Requests with a Retry-After header. No credits are deducted on rate-limited requests.
3

Credit Deduction (Atomic)

The required credits are atomically deducted from your wallet. If your balance is insufficient, you receive 402 Payment Required with the X-Credits-Required and X-Credits-Balance headers so you know exactly how much to top up. The deduction is all-or-nothing — partial charges never occur.
4

Response with Credit Headers

On success, the response includes X-Credits-Deducted and X-Credits-Balance headers so you can track spend in real time. Your application can use these headers to implement budget alerts or automatic top-ups.

​
Credit Response Headers

Every metered API response includes credit-related headers. Which headers appear depends on the response status:
HeaderWhen ReturnedDescription
X-Credits-Deducted200 (success)Number of credits consumed by this specific request.
X-Credits-BalanceAlwaysYour current wallet balance after this request.
X-Credits-Required402 onlyNumber of credits the request would have needed to succeed.

​
Successful Request

HTTP/1.1 200 OK
X-Credits-Deducted: 10
X-Credits-Balance: 9990
Content-Type: application/json

​
Insufficient Credits

HTTP/1.1 402 Payment Required
X-Credits-Required: 10
X-Credits-Balance: 3
Content-Type: application/json

{
  "status": 402,
  "error": "Insufficient credits",
  "credits_required": 10,
  "credits_balance": 3
}
Top up your wallet in the dashboard to resume immediately — no restart or key rotation needed.

​
Cost Calculator

Estimate your monthly spend based on typical volumes:
Use CaseUnitsCredits / UnitTotal CreditsMonthly Cost
Job searches (avg 25 jobs / response)1,000 requests = 25,000 jobs1 / job25,000$25.00
Job searches (avg 25 jobs / response)10,000 requests = 250,000 jobs1 / job250,000$250.00
Jobs Feed bulk pull (pay-per-use)100,000 jobs0.5 / job50,000$50.00
Jobs Feed bulk pull (with subscription)unlimited00subscription only
Geocode lookups5,000 requests1 / request5,000$5.00
Geocode lookups50,000 requests1 / request50,000$50.00
Combined (typical startup)————
1k searches + 5k geocodes + 100k feed jobs (pay-per-use)——80,000$80.00
Search and Feed pricing is per delivered job, not per request — so a search that returns 5 results costs 5 credits, not 25. Empty result sets cost 0.

​
FAQ

1,000 credits = 1.00.EachAPIrequesttoameteredendpointatomicallydeductscreditsfromyourwallet.Creditsneverexpireandtherearenomonthlyminimums.Youcantopupanywherefrom1.00. Each API request to a metered endpoint atomically deducts credits from your wallet. Credits never expire and there are no monthly minimums. You can top up anywhere from 5 to $10,000 in a single transaction.
Metered endpoints return HTTP 402 Payment Required. The response includes X-Credits-Required (credits the request needed) and X-Credits-Balance (your current balance). Top up your wallet and retry — no restart needed.
No. Credits are only deducted on successful (2xx) responses. If your request fails due to rate limits (429), bad parameters (400), authentication errors (401), or server errors (5xx), no credits are consumed.
Yes. Safety-cap rate limits apply per minute, per hour, and per day to prevent abuse and protect service quality. Paid subscribers get significantly higher limits. Credits are deducted only after rate limit checks pass. See the Rate Limits page for details.
Credits are non-refundable but they never expire, so there’s no urgency to use them. Contact support for exceptional circumstances.
The Jobs Feed (POST /api/jobs/feed) is free for Jobs Feed subscribers — per-job charges are waived entirely. On pay-as-you-go plans the same endpoint costs 0.5 credits per delivered job. The expired-jobs endpoint (GET /api/jobs/expired) is always free for everyone, regardless of plan, so callers can keep their inventories clean.
Yes. You can configure low-balance alerts in the dashboard. You can also programmatically monitor spend by reading the X-Credits-Balance header on every metered response.
For high-volume usage (over $1,000/month), contact our sales team at enterprise@jobo.world for custom pricing.