API v1Stable

Job-Radar API

API para acesso programático às vagas de emprego disponíveis no Job-Radar.

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

Visão geral

A API do Job-Radar permite que aplicações externas consultem vagas de emprego, pesquisem oportunidades e integrem os dados do Job-Radar em seus próprios sistemas.

Formato: todas as respostas da API são retornadas em JSON.
Base URL
https://api.job-radar.online/v1

Autenticação

Os endpoints protegidos utilizam um API Token enviado através do header Authorization.

Authorization: Bearer SEU_API_TOKEN Accept: application/json
Importante: nunca exponha o seu API Token em código frontend, repositórios públicos ou aplicações distribuídas diretamente aos utilizadores.

Vagas

GET/jobs
Listar vagas

Retorna uma lista paginada de vagas disponíveis no Job-Radar.

Parâmetros
ParâmetroTipoObrigatórioDescrição
pageintegerNãoPágina desejada.
per_pageintegerNãoNúmero de vagas por página.
citystringNãoFiltra vagas por cidade.
categorystringNãoFiltra vagas por categoria.
Exemplo
GET /v1/jobs?page=1&per_page=20
Resposta
{ "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}
Consultar vaga

Retorna os detalhes de uma vaga específica.

Parâmetros
ParâmetroTipoDescrição
idintegerID da vaga.
Exemplo
GET /v1/jobs/1254
Resposta
{ "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
Pesquisar vagas

Pesquisa vagas utilizando palavras-chave e filtros.

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

Paginação

Endpoints que retornam coleções utilizam paginação para limitar a quantidade de dados retornados em cada requisição.

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

Códigos de resposta

CódigoDescrição
200Requisição processada com sucesso.
201Recurso criado com sucesso.
401Token ausente ou inválido.
422Dados enviados são inválidos.
404Recurso não encontrado.
429Limite de requisições excedido.
500Erro interno do servidor.
Exemplo de erro
{ "message": "Unauthenticated.", "status": 401 }

Exemplos

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