Endpoint de Búsqueda

POST /callerid/search

Busca información de un número telefónico utilizando múltiples fuentes de datos.

Request

URL: /callerid/search

Method: POST

Content-Type: application/json

Body:

{
  "api_key": "tu-token-jwt",
  "query": "34600000001"
}

Parámetros

Parámetro	Tipo	Requerido	Descripción
api_key	string	Sí	Token JWT de autenticación
query	string	Sí	Número telefónico sin el símbolo + (ej: 34600000001)

Response

Status Code: 200 OK

Body:

{
  "success": true,
  "data": {
    "phone_number": "34600000001",
    "callapp": {
      // Resultados de Callapp
    },
    "truecaller": {
      // Resultados de Truecaller
    },
    "combined": {
      "callapp_available": true,
      "truecaller_available": true
    }
  },
  "credits_remaining": 9
}

Códigos de Error

Código	Descripción
400	Número telefónico inválido (debe contener solo dígitos)
401	Token inválido o no proporcionado
403	Sin créditos restantes
429	Rate limit excedido (máximo 30 requests por minuto)
500	Error interno del servidor

Ejemplo con cURL

curl -X POST "https://api.callerosint.org/callerid/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "tu-token-jwt",
    "query": "34600000001"
  }'

Ejemplo con Python

import requests

url = "https://api.callerosint.org/callerid/search"
payload = {
    "api_key": "tu-token-jwt",
    "query": "34600000001"
}

response = requests.post(url, json=payload)
data = response.json()

print(f"Créditos restantes: {data['credits_remaining']}")
print(f"Resultados: {data['data']}")

Notas

• El número telefónico debe enviarse sin el símbolo +
• El formato esperado es: código de país + número (ej: 34600000001)
• Cada búsqueda consume un crédito del token
• Los resultados incluyen información de múltiples fuentes cuando está disponible