Visão geral
A API de Horóscopo é uma API de consulta. O seu site/app deve realizar uma requisição para um dos nossos endpoints sempre que desejar obter as previsões do dia.
Ferramentas disponíveis no painel
Exibe o total consumido e o limite disponível para o módulo contratado.
Mostra a data e hora da última consulta feita pelo site/app.
Permite desativar temporariamente as consultas da API.
Exibe o endpoint configurado para uso na integração.
Permite visualizar, alterar ou gerar um novo token de autenticação.
Lista consultas realizadas e permite visualizar o JSON retornado.
Permite conferir as previsões salvas no painel antes de usar no site/app.
Valida se a rota está acessível e respondendo corretamente.
Início rápido
- Copie o endpoint exibido no painel da API de Horóscopo.
- Copie o token Bearer do painel e mantenha-o protegido no backend do seu sistema.
- Faça uma requisição GET ou POST para o endpoint usando o cabeçalho
Authorization: Bearer SEU_TOKEN. - Leia o array
dadosda resposta JSON para exibir previsão, dezenas e cores por signo.
Autenticação
Toda consulta deve enviar o token no cabeçalho Authorization, no formato Bearer. Requisições sem token, com token inválido ou em formato incorreto serão recusadas.
Accept: application/json
Authorization: Bearer 396637E250B0FE02BDD6162A
Como consultar
O endpoint aceita GET e POST. Em POST, também aceita corpo JSON, form-data ou x-www-form-urlencoded. Atualmente, a previsão retornada é a previsão diária da data de referência do servidor.
https://api.lotoserv.com/horoscopo/v1/Mais simples para consumo e cache do seu sistema.Content-Type: application/jsonDisponível para sistemas que padronizam integrações via POST.Resposta JSON
Quando a consulta é autorizada e há previsões cadastradas para o dia, a API retorna HTTP 200 com os dados do usuário, informações da consulta e a lista de previsões.
| Campo | Descrição |
|---|---|
usuario.terminal | Identificador do terminal vinculado ao usuário. |
usuario.site_app | Nome do site/app cadastrado no painel. |
consulta.numero | Número atual de consultas consumidas pelo usuário. |
consulta.data | Data e hora da consulta no formato brasileiro. |
consulta.ip | IP de origem da requisição. |
informacoes.tipo_api | Tipo da API retornada, neste caso Horóscopo Diário. |
informacoes.data_referencia | Data de referência das previsões no formato YYYY-mm-dd. |
informacoes.total_registros | Total de previsões retornadas. |
dados[].signo | Nome do signo. |
dados[].previsao | Texto da previsão diária. |
dados[].dezenas | Dezenas ou números da sorte vinculados ao signo. |
dados[].cores | Cores indicadas para o signo. |
{
"usuario": {
"terminal": "6715",
"site_app": "Meu Site/App"
},
"consulta": {
"numero": "128",
"data": "14/06/2026 02:14:10",
"ip": "189.00.00.00"
},
"informacoes": {
"tipo_api": "Horóscopo Diario",
"data_referencia": "2026-06-14",
"total_registros": 12
},
"dados": [
{
"signo": "Áries",
"previsao": "Hoje é um bom dia para agir com confiança, mas sem pressa. Observe oportunidades e evite decisões impulsivas.",
"dezenas": "04, 18, 29",
"cores": "Vermelho, Branco"
},
{
"signo": "Touro",
"previsao": "Organização e paciência ajudam a resolver pendências. Valorize conversas objetivas e escolhas práticas.",
"dezenas": "07, 21, 36",
"cores": "Verde, Bege"
}
]
}
Signos retornados
O retorno padrão contempla os 12 signos. A ordem pode variar de acordo com o cadastro interno, então recomendamos localizar o signo pelo campo signo, e não pela posição no array.
Erros, limites e respostas
Token inválido/ausenteO token não foi enviado, está incorreto ou fora do formato Bearer.Limite atingidoO módulo atingiu o limite de requisições contratado.Sem previsãoAinda não existem previsões registradas para a data de referência.{
"status": "error",
"code": "401",
"message": "Token nao fornecido"
}{
"status": "error",
"code": "401",
"message": "Seu módulo atingiu o limite de 10000 requisições diárias."
}{
"status": "error",
"code": "401",
"message": "Ainda não há previsões registradas para 14/06/2026"
}Exemplos por linguagem
Use os exemplos abaixo para consultar o horóscopo do dia. Troque o endpoint e o token pelos dados exibidos no painel do usuário.
curl -X GET 'https://api.lotoserv.com/horoscopo/v1/' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL'
<?php
header('Content-Type: text/html; charset=utf-8');
$endpoint = 'https://api.lotoserv.com/horoscopo/v1/';
$token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_TIMEOUT => 20,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'Authorization: Bearer '.$token
]
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$erroCurl = curl_error($ch);
curl_close($ch);
if ($erroCurl) {
die('Erro de conexão: '.$erroCurl);
}
$dados = json_decode($response, true);
if ($httpCode !== 200 || !is_array($dados)) {
echo '<pre>Erro na consulta: '.htmlspecialchars($response).'</pre>';
exit;
}
foreach ($dados['dados'] as $signo) {
echo '<h3>'.htmlspecialchars($signo['signo']).'</h3>';
echo '<p>'.htmlspecialchars($signo['previsao']).'</p>';
echo '<p><b>Dezenas:</b> '.htmlspecialchars($signo['dezenas']).'</p>';
echo '<p><b>Cores:</b> '.htmlspecialchars($signo['cores']).'</p>';
echo '<hr>';
}
const endpoint = 'https://api.lotoserv.com/horoscopo/v1/';
const token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';
async function consultarHoroscopo() {
const resposta = await fetch(endpoint, {
method: 'GET',
headers: {
'Accept': 'application/json',
'Authorization': `Bearer ${token}`
}
});
const dados = await resposta.json();
if (!resposta.ok) {
console.error('Erro na consulta:', dados);
return;
}
dados.dados.forEach((signo) => {
console.log(signo.signo, signo.previsao, signo.dezenas, signo.cores);
});
}
consultarHoroscopo();
const endpoint = 'https://api.lotoserv.com/horoscopo/v1/';
const token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';
async function consultarHoroscopo() {
const resposta = await fetch(endpoint, {
method: 'GET',
headers: {
'Accept': 'application/json',
'Authorization': `Bearer ${token}`
}
});
const dados = await resposta.json();
if (!resposta.ok) {
console.error('Erro na consulta:', dados);
return;
}
console.log('Data referência:', dados.informacoes.data_referencia);
console.log('Total de signos:', dados.informacoes.total_registros);
for (const item of dados.dados) {
console.log(`${item.signo}: ${item.previsao}`);
console.log(`Dezenas: ${item.dezenas} | Cores: ${item.cores}`);
}
}
consultarHoroscopo();
import requests
endpoint = 'https://api.lotoserv.com/horoscopo/v1/'
token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL'
headers = {
'Accept': 'application/json',
'Authorization': f'Bearer {token}'
}
resposta = requests.get(endpoint, headers=headers, timeout=20)
dados = resposta.json()
if resposta.status_code != 200:
print('Erro na consulta:', dados)
exit()
print('Data referência:', dados['informacoes']['data_referencia'])
print('Total de signos:', dados['informacoes']['total_registros'])
for signo in dados['dados']:
print(signo['signo'])
print(signo['previsao'])
print('Dezenas:', signo['dezenas'])
print('Cores:', signo['cores'])
print('-' * 30)
using System.Net.Http.Headers;
using System.Text.Json;
var endpoint = "https://api.lotoserv.com/horoscopo/v1/";
var token = "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL";
using var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
var response = await client.GetAsync(endpoint);
var body = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
{
Console.WriteLine("Erro na consulta:");
Console.WriteLine(body);
return;
}
using var json = JsonDocument.Parse(body);
var root = json.RootElement;
Console.WriteLine("Data referência: " + root.GetProperty("informacoes").GetProperty("data_referencia").GetString());
foreach (var signo in root.GetProperty("dados").EnumerateArray())
{
Console.WriteLine(signo.GetProperty("signo").GetString());
Console.WriteLine(signo.GetProperty("previsao").GetString());
Console.WriteLine("Dezenas: " + signo.GetProperty("dezenas").GetString());
Console.WriteLine("Cores: " + signo.GetProperty("cores").GetString());
}
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
"time"
)
func main() {
endpoint := "https://api.lotoserv.com/horoscopo/v1/"
token := "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL"
client := &http.Client{Timeout: 20 * time.Second}
req, err := http.NewRequest("GET", endpoint, nil)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("Authorization", "Bearer "+token)
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
if resp.StatusCode != 200 {
fmt.Println("Erro na consulta:", string(body))
return
}
var dados map[string]interface{}
json.Unmarshal(body, &dados)
fmt.Println("Resposta:", dados)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ConsultaHoroscopo {
public static void main(String[] args) throws Exception {
String endpoint = "https://api.lotoserv.com/horoscopo/v1/";
String token = "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(endpoint))
.GET()
.header("Accept", "application/json")
.header("Authorization", "Bearer " + token)
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 200) {
System.out.println("Erro na consulta:");
System.out.println(response.body());
return;
}
System.out.println(response.body());
}
}
curl -X POST 'https://api.lotoserv.com/horoscopo/v1/' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL' \
-d '{}'