Documentación de la API

Integra comprobaciones de huella digital en tu aplicación. Busca correos, teléfonos, nombres de usuario y más mediante la API REST.

Obtén tu clave de API Ver endpoints

URL base: https://api.digitalfootprintcheck.com

Cabecera de autenticación: Authorization: Basic key-YOUR_API_KEY

Límite de uso: 5.000 solicitudes por hora

Tipo de contenido: application/json

Cómo obtener una clave de API

Suscríbete a un plan Pro o Business
Ve a Cuenta > Claves de API en tu panel
Haz clic en Nueva clave de API y selecciona los permisos que necesites
Copia tu clave (empieza por key-)

Ejemplo: crear una búsqueda

cURL

curl -X POST https://api.digitalfootprintcheck.com/api/search \
  -H "Authorization: Basic key-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identity":"example@gmail.com"}'

JavaScript

const res = await fetch('https://api.digitalfootprintcheck.com/api/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic key-YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ identity: 'example@gmail.com' })
});
const data = await res.json();
console.log(data.data.searchId);

Python

import requests

res = requests.post(
    'https://api.digitalfootprintcheck.com/api/search',
    headers={
        'Authorization': 'Basic key-YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={'identity': 'example@gmail.com'}
)
data = res.json()
print(data['data']['searchId'])

Endpoints de la API

POST/api/search

Inicia una búsqueda y devuelve un searchId de inmediato. Consulta GET /api/search/:id hasta que complete sea true. Consume 1 crédito.

Cuerpo de la solicitud

Campo	Tipo	Descripción
identity	string	Correo, teléfono, nombre de usuario o nombre completo

Respuesta (201)

{
  "data": {
    "searchId": "a1b2c3d4-...",
    "identity": "user@example.com",
    "complete": false,
    "paid": true
  }
}

GET/api/search/:id

Consulta los resultados. Las búsquedas suelen completarse en 15 a 60 segundos. Consulta cada 3 segundos.

Respuesta al completarse (200)

{
  "data": {
    "searchId": "a1b2c3d4-...",
    "identity": "user@example.com",
    "complete": true,
    "report": { "employment": [...], ... }
  }
}

Ejemplo de consulta (JavaScript)

async function pollUntilComplete(searchId) {
  while (true) {
    const res = await fetch(
      'https://api.digitalfootprintcheck.com/api/search/' + searchId,
      { headers: { Authorization: 'Basic key-YOUR_KEY' } }
    );
    const data = (await res.json()).data;
    if (data.complete) return data;
    await new Promise(r => setTimeout(r, 3000));
  }
}

GET/api/search

Lista todas las búsquedas de tu cuenta, las más recientes primero.

GET/api/account

Obtén los datos de la cuenta: plan, créditos restantes y estado de la suscripción.

GET/api/user

Obtén la información del perfil de usuario.

GET/api/key

Lista todas las claves de API (enmascaradas). Usa GET /api/key/:id para ver una clave completa.

Códigos de error

Código	Significado
401	Clave de API no válida o ausente
402	Créditos insuficientes: mejora tu plan
403	La clave de API no tiene el permiso necesario
429	Límite de uso superado: espera y vuelve a intentarlo
500	Error del servidor: contacta con soporte si persiste

¿Listo para construir?

Suscríbete a un plan Pro o Business, crea una clave de API y empieza a integrarla en minutos.

Ver planes Gestionar claves de API