Documentation

API URL


GET /api/v1/logo/discover

Headers
Code
Content-Type: application/json
Query Parameters


Example GET Request

Code
GET https://datpaq.com/api/v1/logo/discover?domain=example.com&includePalette=true&api_key=your-api-key

Successful Response

Status
HTML
200 OK
Body
Code
{
  "success": true,
  "domain": "example.com",
  "found": true,
  "sourceUrl": "https://example.com/favicon.ico",
  "imageBase64": "<base64>",
  "byteLength": 4096,
  "palette": {
    "dominant": "#1a1a1a",
    "colors": [
      {
        "hex": "#1a1a1a",
        "rgb": {
          "r": 26,
          "g": 26,
          "b": 26
        },
        "weight": 0.62
      }
    ],
    "width": 64,
    "height": 64
  },
  "sourcesTried": [
    {
      "url": "https://example.com/favicon.ico",
      "ok": true,
      "status": 200,
      "fromCache": false
    }
  ],
  "correlationId": "req_abc123",
  "metadata": {},
  "updatedAt": "2026-09-12T00:00:00.000Z"
}

Error Response

Example
Code
HTTP 400 ValidationError: Invalid domain or malformed body — Request rejected before discovery; HTTP 400 SsrfBlocked: Domain resolves to private or reserved target — Destination blocked by SSRF guard; HTTP 401 AuthenticationError: Gateway authentication failure — Request rejected due to missing or invalid API credentials; HTTP 404 NotFound: Unknown endpoint path — Request path does not map to available logo routes; HTTP 429 RateLimitError: More than 30 requests in 15 minutes — Request rejected by service rate limiter; HTTP 500 InternalError: Unexpected discovery failure — Logo discovery could not complete; HTTP 502 UpstreamUnavailable: All candidate asset sources unavailable — Logo discovery upstream unavailable; HTTP 504 UpstreamTimeout: Candidate asset sources exceeded the fetch deadline — Logo discovery timed out

Last Updated:  May 4, 2026