API Documentation

Integrate bizApply's job data into your applications with our REST API.

Base URL: https://bizapply.ai/api/v1

6 endpoints

JSON + REST

Overview

The bizApply API gives you programmatic access to the world's largest aggregated job database. Search millions of job listings across 195+ countries, run data insight queries, and access company profiles -- all through a simple REST interface.

Job Search

Weighted search with 10+ filter dimensions and AI-powered natural language parsing.

Data Insights

40+ prebuilt analytical queries: salary benchmarks, skill trends, geographic distributions.

Company Data

Access company profiles, job counts, and industry information.

Base URL

https://bizapply.ai/api/v1

All endpoints are relative to this base URL. Responses are JSON with UTF-8 encoding.

Authentication

The API supports both anonymous and authenticated access. Authenticated requests receive higher rate limits and access to additional features.

API Key Authentication

Include your API key in the X-API-Key header with every request:

GET /api/v1/jobs/{id} HTTP/1.1
Host: bizapply.ai
X-API-Key: your-api-key-here
Content-Type: application/json

Getting an API Key

API keys are available through your bizApply employer account. Sign up at bizapply.ai/become-employer and generate keys from your account settings. Anonymous access (no key required) is available for all endpoints with lower rate limits.

Anonymous

No API key required. Subject to lower rate limits. Suitable for testing and evaluation.

Authenticated

API key in X-API-Key header. Higher rate limits and priority processing.

Rate Limits

Rate limits are enforced per IP address (anonymous) or per API key (authenticated). When you exceed the limit, the API returns a 429 Too Many Requests response.

Tier	Rate Limit	Window	Queue
Anonymous	100 requests	1 hour	No queue
Authenticated	1,000 requests	1 hour	10 queued
Premium	10,000 requests	1 hour	50 queued

Rate limit response

When rate limited, the response includes a retry-after hint:

{
  "error": "Too many requests",
  "retryAfterSeconds": 60
}

Note: The AI-powered endpoints (/jobs/search/parse and /jobs/insights) have a stricter per-IP rate limit of 10 requests per minute to manage LLM costs.

Endpoint Reference

Click on any endpoint to expand its full documentation, including request/response schemas and a live "Try It" feature that calls the real API.

Code Examples

Complete examples showing how to use the API in different languages. Replace your-api-key-here with your actual API key.

# Weighted job search
curl -X POST https://bizapply.ai/api/v1/jobs/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "keywords": "React developer",
    "keywords_weight": 0.8,
    "country": "Germany",
    "country_weight": 0.6,
    "isRemote": true,
    "isRemote_weight": 0.7,
    "page": 1,
    "pageSize": 10
  }'

# Natural language search parsing
curl -X POST https://bizapply.ai/api/v1/jobs/search/parse \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{"query": "remote senior Python developer in Berlin"}'

# Get job details
curl https://bizapply.ai/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "X-API-Key: your-api-key-here"

# List companies
curl "https://bizapply.ai/api/v1/companies?page=1&pageSize=10" \
  -H "X-API-Key: your-api-key-here"

Error Handling

The API uses standard HTTP status codes. Errors include a JSON body with details.

Status	Meaning	Common Cause
200	OK	Request succeeded
400	Bad Request	Invalid request body or missing required fields
404	Not Found	Job/company ID does not exist
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server-side error (please retry)

Schema Reference

Each job in the weighted search response includes these fields:

Field	Type	Description
id	GUID	Unique job identifier
title	string	Job title
shortDescription	string?	Brief job summary
type	string?	FullTime, PartTime, Contract, Freelance, Internship, Temporary
experienceLevel	string?	Entry, Junior, Mid, Senior, Lead, Executive
salaryMin	number?	Minimum annual salary
salaryMax	number?	Maximum annual salary
salaryCurrency	string?	ISO 4217 currency code
isRemote	boolean	Whether position is remote
applicationUrl	string?	URL to apply
createdAt	string	ISO 8601 creation timestamp
companyName	string?	Hiring company name
companySlug	string?	Company URL slug
companyWebsite	string?	Company website URL
companyLogoUrl	string?	Company logo URL
country	string?	Job country
city	string?	Job city
state	string?	Job state/region
score	number	Relevance score (0-1)

Ready to integrate?

Get started with the bizApply API today. No credit card required for anonymous access.

Get API Key Browse Insights