/analyze Submit domains for operator attribution analysis — individually, or in batches of up to 50.
Loading...
Next step: After submitting, poll
GET /jobs/{id}
with the returned job_id to get results.
Batch partial success: Each domain in a
/analyze/batch
request is processed independently. The status code reflects the outcome:
202 if every domain was accepted,
207 if some succeeded and some failed, and
422 if all failed. Inspect each entry in
jobs[] — accepted domains carry a
job_id, failed ones carry an
error. Any quota or credit consumed for a domain that fails to dispatch is automatically returned and reported in
credits_refunded.
Sandbox Domains
Use these special domains for CI/CD testing. They return fixed, predictable responses without running collectors or consuming quota.
| Domain | Behavior |
|---|---|
test-corp.whoisgeni.us |
Returns high confidence (0.95) result with entity "Test Corporation"
|
test-unknown.whoisgeni.us |
Returns low confidence (0.25) result with no clear entity
|
Test domain queries are free and do not consume credits.
Example
curl -X POST https://api.whoisgeni.us/analyze \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "test-corp.whoisgeni.us"}'