Six metered endpoints served from Cloudflare's edge. Authenticate with your API key in the x-api-key header. Free tier includes 500 calls/day.
Base URL: https://redeye-api-suite.piratecove.workers.dev. All requests require the x-api-key header. Get a key at /signup.
Reverse DNS and geo/ASN lookup for any public IPv4 or IPv6 address.
curl -H "x-api-key: rdye_your_key" \
https://redeye-api-suite.piratecove.workers.dev/v1/ip/8.8.8.8
{
"ip": "8.8.8.8",
"reverse_dns": "dns.google",
"city": "Mountain View",
"region": "California",
"country": "United States",
"country_code": "US",
"postal": "94043",
"lat": 37.42,
"asn": "AS15169",
"isp": "Google LLC",
"cached": false
}
Registration (RDAP) data plus the live DNS record set for a domain.
curl -H "x-api-key: rdye_your_key" \
https://redeye-api-suite.piratecove.workers.dev/v1/domain/example.com
{
"domain": "example.com",
"registrar": "RESERVED-Internet Assigned Numbers Authority",
"created": "1995-08-14T04:00:00Z",
"updated": "...",
"expires": "...",
"status": ["client delete prohibited"],
"nameservers": ["a.iana-servers.net", "b.iana-servers.net"],
"dns_records": { "A": ["93.184.216.34"], "MX": ["..."], "TXT": ["..."] },
"cached": false
}
JSON body only. Checks syntax (RFC 5321 length limits enforced), MX records, and disposable-domain lists. Invalid syntax returns HTTP 200 with valid:false.
curl -X POST \ -H "x-api-key: rdye_your_key" \ -H "Content-Type: application/json" \ -d '{"email":"user@example.com"}' \ https://redeye-api-suite.piratecove.workers.dev/v1/email/validate
{
"email": "user@example.com",
"valid": true,
"reason": "ok",
"mx_found": true,
"disposable": false
}
Query parameters lat and lon are required numbers.
curl -H "x-api-key: rdye_your_key" \ "https://redeye-api-suite.piratecove.workers.dev/v1/weather?lat=51.5&lon=-0.12"
{
"lat": 51.5,
"lon": -0.12,
"timezone": "Europe/London",
"current": { "temperature_2m": 15.3, "wind_speed_10m": 11.2, "...": "..." },
"forecast_3day": { "time": ["...", "...", "..."], "temperature_2m_max": [...] },
"cached": false
}
JSON body only (not multipart): { "files_base64": [ ... ] }. Accepts 2–20 base64-encoded PDFs. Returns the merged document as base64.
curl -X POST \ -H "x-api-key: rdye_your_key" \ -H "Content-Type: application/json" \ -d '{"files_base64":["JVBERi0xLjQK...","JVBERi0xLjQK..."]}' \ https://redeye-api-suite.piratecove.workers.dev/v1/pdf/merge
{
"file_base64": "JVBERi0xLjcK...",
"pages": 2
}
JSON body only: { "file_base64": "...", "text": "..." }. Stamps the given text diagonally across every page.
curl -X POST \ -H "x-api-key: rdye_your_key" \ -H "Content-Type: application/json" \ -d '{"file_base64":"JVBERi0xLjQK...","text":"CONFIDENTIAL"}' \ https://redeye-api-suite.piratecove.workers.dev/v1/pdf/watermark
{
"file_base64": "JVBERi0xLjcK...",
"pages": 1
}
| Status | error | Meaning |
|---|---|---|
| 400 | invalid_body | Malformed or non-JSON request body |
| 400 | invalid_ip / invalid_domain / invalid_coords | Parameter failed validation |
| 400 | reserved_ip | Private/reserved address ranges are not lookup-able |
| 401 | missing x-api-key / Key not recognized | Missing or unknown API key |
| 402 | free_tier_exhausted / insufficient_credit | Daily 500 free calls used, or prepaid balance empty — top up to continue |
| 422 | merge_failed / watermark_failed | Input could not be parsed as PDF |
| 502 | upstream_failed / lookup_failed | Upstream data source unavailable |
| Plan | Cost | Notes |
|---|---|---|
| Free | $0 | 500 calls/day across all endpoints, no card required |
| Pay-as-you-go | per-call rates above | Prepaid credit balance, draws down per call |