API URL
GET /api/v1/logo/discover
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
domain
required
string
Hostname or URL to discover assets for (3-253 chars; www. stripped)
includePalette
optional
boolean
Extract dominant colors from selected image (default true)
Example GET Request
Code
GET https://datpaq.com/api/v1/logo/discover?domain=example.com&includePalette=true&api_key=your-api-keySuccessful Response
Status
HTML
200 OKBody
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"
}Field
Type
success
boolean
domain
string
found
boolean
sourceUrl
string
imageBase64
string
byteLength
number
palette
object
sourcesTried
array
correlationId
string
metadata
object
metadata_correlationId
string
metadata_timestamp
string
metadata_api_token_name
string
metadata_rate_limit
object
updatedAt
string
processingTime
string
status
string
service
string
version
string
error
object
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 outLast Updated: May 4, 2026