API v1Stable

Job-Radar API

API for programmatic access to the job vacancies available on Job-Radar.

https://api.job-radar.online/v1

Overview

The Job-Radar API allows external applications to query job vacancies, search opportunities and integrate Job-Radar data into their own systems.

Format: all API responses are returned in JSON.
Base URL
https://api.job-radar.online/v1

Authentication

Protected endpoints use an API Token sent through the header Authorization.

Authorization: Bearer SEU_API_TOKEN Accept: application/json
Important: never expose your API Token in frontend code, public repositories or applications distributed directly to users.
Como obter o token

A chave é emitida depois de contratar um dos planos de API. Na área reservada, em Chaves de API é possível gerar, revogar e eliminar chaves. O valor apenas é apresentado no momento em que a chave é criada.

Limites de pedidos

Cada plano define o número máximo de pedidos por minuto. As respostas incluem os headers X-RateLimit-Limit e X-RateLimit-Remaining Quando o limite é ultrapassado, a API responde com o código 429.

O token também deixa de servir quando a assinatura termina ou é cancelada, mesmo que a chave em si continue válida.

Jobs

GET/jobs
List jobs

Returns a paginated list of jobs available on Job-Radar.

Parameters
ParameterTypeRequiredDescription
pageintegerNoDesired page.
per_pageintegerNoNumber of jobs per page.
citystringNoFilters jobs by city.
categorystringNoFilters jobs by category.
Example
GET /v1/jobs?page=1&per_page=20
Response
{ "data": [ { "id": 1254, "title": "Software Developer", "company": "Example Company", "location": "Maputo", "type": "Full Time", "category": "Tecnologias de Informação", "url": "https://job-radar.online/jobs/1254", "published_at": "2026-08-15" } ], "meta": { "current_page": 1, "per_page": 20, "total": 1254, "last_page": 63 } }
GET/jobs/{id}
Get job

Returns the details of a specific job.

Parameters
ParameterTypeDescription
idintegerJob ID.
Example
GET /v1/jobs/1254
Response
{ "data": { "id": 1254, "title": "Software Developer", "company": "Example Company", "location": "Maputo", "type": "Full Time", "category": "Tecnologias de Informação", "description": "Descrição da vaga...", "requirements": [ "PHP", "Laravel", "MySQL" ], "url": "https://job-radar.online/jobs/1254", "published_at": "2026-08-15" } }
GET/jobs/search
Search jobs

Searches jobs using keywords and filters.

Example
GET /v1/jobs/search?q=laravel&city=Maputo

Pagination

Endpoints that return collections use pagination to limit the amount of data returned in each request.

{ "data": [], "meta": { "current_page": 1, "per_page": 20, "total": 150, "last_page": 8 } }

Response codes

CodeDescription
200Request processed successfully.
201Resource created successfully.
401Missing or invalid token.
403Token válido, mas sem assinatura de API activa.
422Sent data is invalid.
404Resource not found.
429Request limit exceeded.
500Internal server error.
Error example
{ "message": "Unauthenticated.", "status": 401 }

Examples

GET /v1/jobs
curl -X GET "https://api.job-radar.online/v1/jobs" \ -H "Authorization: Bearer SUA_API_KEY" \ -H "Accept: application/json"
PHP
<?php $ch = curl_init( 'https://api.job-radar.online/v1/jobs' ); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer SUA_API_KEY', 'Accept: application/json', ], ]); $response = curl_exec($ch); curl_close($ch); $data = json_decode($response, true); print_r($data);
JavaScript
const response = await fetch( 'https://api.job-radar.online/v1/jobs', { method: 'GET', headers: { 'Authorization': 'Bearer SUA_API_KEY', 'Accept': 'application/json' } } ); const data = await response.json(); console.log(data);
Java
import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create( "https://api.job-radar.online/v1/jobs" )) .header( "Authorization", "Bearer SUA_API_KEY" ) .header( "Accept", "application/json" ) .GET() .build(); HttpResponse<String> response = client.send( request, HttpResponse.BodyHandlers.ofString() ); System.out.println(response.body()); } }
Python
import requests url = "https://api.job-radar.online/v1/jobs" headers = { "Authorization": "Bearer SUA_API_KEY", "Accept": "application/json" } response = requests.get( url, headers=headers ) data = response.json() print(data)
Job-Radar APIv1