🔍 REX LOOKUP API Documentation

Welcome to the REX LOOKUP API. This API allows you to perform background checks and lookups programmatically using your API key.

🔐 Authentication

All requests require an API key. Include it in your request body:

{
  "api_key": "your-api-key-here"
}

Note: Contact admin to obtain your API key. Keep your API key secret!

⚡ Rate Limits

Important: API is rate limited to prevent abuse:

30 requests per minute per IP address
800 requests per hour per IP address
Exceeded limit = 1 hour block

If you exceed the rate limit, you'll receive a 429 Too Many Requests error.

📍 Base URL

https://www.rexlookup.shop

🌐 Endpoints

GET /api/v1/health

Description: Check if API server is running

Response:

{
  "status": "ok",
  "message": "REX_LOOKUP API server is running",
  "version": "1.0"
}

GET /api/v1/balance

Description: Check your API key balance

Parameters:

api_key - Your API key (query parameter or JSON body)

Example Request:

curl "https://www.rexlookup.shop/api/v1/balance?api_key=YOUR_KEY"

Response:

{
  "status": "success",
  "balance": 100.50,
  "client_name": "Client Name",
  "created_at": "2024-01-01 12:00:00"
}

GET /api/v1/services

Description: List all available services

Response:

{
  "status": "success",
  "services": {
    "ssn_dob": {
      "description": "SSN + DOB Lookup",
      "required_fields": ["first_name", "last_name", "address", "city", "state", "zip_code"],
      "price": 5.0,
      "batch": false
    },
    "revers_ssn": {
      "description": "Reverse SSN Lookup",
      "required_fields": ["ssn"],
      "price": 3.0,
      "batch": false
    },
    "dl": {
      "description": "Driver License Lookup",
      "required_fields": ["first_name", "last_name", "address", "city", "state", "zip_code", "dob"],
      "price": 6.0,
      "batch": false
    },
    "cr": {
      "description": "Credit Report",
      "required_fields": ["first_name", "last_name", "address", "city", "state", "zip_code", "dob", "ssn"],
      "price": 8.0,
      "batch": false
    },
    "cs": {
      "description": "Credit Score Lookup",
      "required_fields": ["first_name", "last_name", "address", "city", "state", "zip_code", "dob", "ssn"],
      "price": 4.0,
      "batch": false
    }
  }
}

POST /api/v1/lookup

Description: Perform a lookup

Supported Services:

Service	Description	Price
`ssn_dob`	SSN + DOB Lookup	$5.00
`revers_ssn`	Reverse SSN Lookup	$3.00
`dl`	Driver License Lookup	$6.00
`cr`	Credit Report	$8.00
`cs`	Credit Score Lookup	$4.00

Option 1: Structured Data

{
  "api_key": "your-api-key",
  "service": "ssn_dob",
  "data": {
    "first_name": "John",
    "last_name": "Smith",
    "address": "123 Main St",
    "city": "Dallas",
    "state": "TX",
    "zip_code": "75201"
  }
}

Option 2: Free-form Text (Auto-parsed)

{
  "api_key": "your-api-key",
  "service": "ssn_dob",
  "text": "John Smith\n123 Main St\nDallas, TX 75201"
}

✨ Universal Parser: Our API automatically parses any input format!

Multi-line format
Pipe-separated: John Smith | 123 Main St | Dallas, TX 75201
Comma-separated: John, Smith, 123 Main St, Dallas, TX, 75201

Success Response (200 OK):

{
  "status": "success",
  "service": "ssn_dob",
  "data": {
    "dob": "03/15/1985",
    "ssn": "123-45-6789"
  }
}

Not Found Response (200 OK):

{
  "status": "not_found",
  "message": "No data found"
}

💸 Auto-Refund: Your balance is automatically refunded if no data is found!

Error Responses:

// Invalid API Key (401)
{
  "status": "error",
  "message": "Invalid or inactive API key"
}

// Insufficient Balance (402)
{
  "status": "error",
  "message": "Insufficient balance",
  "required": 5.0,
  "current_balance": 2.50
}

// Missing Fields (400)
{
  "status": "error",
  "message": "Could not extract required fields from text: city, state",
  "parsed": {
    "first_name": "John",
    "last_name": "Smith",
    "street": "123 Main St"
  }
}

// Rate Limit Exceeded (429)
{
  "status": "error",
  "message": "Rate limit exceeded. Maximum 30 requests per minute and 800 requests per hour.",
  "retry_after": "60 seconds"
}

💻 Code Examples

Python

import requests

API_KEY = "your-api-key-here"
BASE_URL = "https://www.rexlookup.shop"

# Check balance
response = requests.get(f"{BASE_URL}/api/v1/balance", params={"api_key": API_KEY})
print(response.json())

# Perform lookup with structured data
data = {
    "api_key": API_KEY,
    "service": "ssn_dob",
    "data": {
        "first_name": "John",
        "last_name": "Smith",
        "address": "123 Main St",
        "city": "Dallas",
        "state": "TX",
        "zip_code": "75201"
    }
}
response = requests.post(f"{BASE_URL}/api/v1/lookup", json=data)
print(response.json())

# Perform lookup with free-form text
data = {
    "api_key": API_KEY,
    "service": "ssn_dob",
    "text": "John Smith\n123 Main St\nDallas, TX 75201"
}
response = requests.post(f"{BASE_URL}/api/v1/lookup", json=data)
print(response.json())

cURL

# Check balance
curl "https://www.rexlookup.shop/api/v1/balance?api_key=YOUR_KEY"

# Perform lookup
curl -X POST https://www.rexlookup.shop/api/v1/lookup \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "service": "ssn_dob",
    "text": "John Smith\n123 Main St\nDallas, TX 75201"
  }'

JavaScript (Node.js)

const axios = require('axios');

const API_KEY = 'your-api-key-here';
const BASE_URL = 'https://www.rexlookup.shop';

// Check balance
const balance = await axios.get(`${BASE_URL}/api/v1/balance`, {
  params: { api_key: API_KEY }
});
console.log(balance.data);

// Perform lookup
const result = await axios.post(`${BASE_URL}/api/v1/lookup`, {
  api_key: API_KEY,
  service: 'ssn_dob',
  text: 'John Smith\n123 Main St\nDallas, TX 75201'
});
console.log(result.data);

❓ FAQ

How do I get an API key?

Contact the administrator via Telegram to obtain your API key.

What happens if a lookup returns "not found"?

Your balance is automatically refunded - you only pay for successful lookups!

Can I use custom pricing?

Yes! Contact admin to set up custom pricing for your API key.

What input formats are supported?

Our Universal Parser supports any format: multi-line, pipe-separated, comma-separated, tab-separated, and more!

📞 Support

For support, questions, or to request an API key, contact us via Telegram: @dl_usa_ssn