Infoga API Documentation

1. Search Domain Emails

Retrieve emails associated with a specific domain.

Endpoint

GET /v1/scan

Parameters

• domain (required): The domain to search for emails
• engine (optional): The search engine to use (e.g., google, bing, yahoo, pgp, all)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     'https://api.infoga.io/v1/scan?domain=example.com&engine=google'

Response

{
    "status": "success",
    "task_id": "e931ef16-278e-4868-9600-9eba23e23d95"
}

2. Get Scan Results

Retrieve the results of a previously initiated scan.

Endpoint

GET /v1/results

Parameters

• task_id (required): The ID of the scan task

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     'https://api.infoga.io/v1/results?task_id=e931ef16-278e-4868-9600-9eba23e23d95'

Response

{
    "status": "success",
    "data": {
        "emails": [
            "contact@example.com",
            "support@example.com"
        ],
        "sources": [
            "Google Search",
            "Company Website"
        ]
    }
}

3. Email Leak Check

Check if an email address has been involved in any known data breaches.

Endpoint

GET /v1/check

Parameters

• email (required): The email address to check

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     'https://api.infoga.io/v1/check?email=user@example.com'

Response

{
    "status": "success",
    "data": {
        "leaked": true,
        "breaches": [
            {
                "name": "ExampleBreach",
                "date": "2022-01-01",
                "description": "Description of the breach"
            }
        ]
    }
}

4. Email Alerting

Set up an alert for an email address in the Infoga database

Endpoint

POST /v1/alert

Parameters

• email (required): The email address to monitor
• alert_email (required): The email address to receive alerts

Example Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"email": "user@example.com", "alert_email": "security-team@example.com"}' \
     'https://api.infoga.io/v1/alert'

Response

{
    "status": "success",
    "message": "Alert set up successfully"
}