Get a publisher icon

Fetches an enabled publisher's declared site icon using that publisher's website as the Referer and Origin, then caches the image for up to one year. Declared page icons are preferred (sizes near 48px first); Google's favicon service is the fallback, and /favicon.ico is tried last. Enabled source domains and a fixed allowlist of featured publishers are accepted.

GEThttps://apis.newssearchapi.com/v1/publisher-icons/{domain}Public · no key

Parameters

domainstringpathRequired
The publisher website hostname, without a scheme or path.

Response 200 · image/*

Publisher icon bytes.

Errors

Every error uses the same envelope with a stable code. See error handling for which ones to retry.

404No enabled publisher matches the requested domain.
429Publisher icon request rate limit exceeded.
503A backing service is unavailable or timed out (`serviceUnavailable`). Not billable.

curl "https://apis.newssearchapi.com/v1/publisher-icons/example-id"

const response = await fetch("https://apis.newssearchapi.com/v1/publisher-icons/example-id");
const data = await response.json();

import os
import requests

response = requests.get(
    "https://apis.newssearchapi.com/v1/publisher-icons/example-id",
)
data = response.json()

req, _ := http.NewRequest(
    "GET",
    "https://apis.newssearchapi.com/v1/publisher-icons/example-id",
    nil,
)
resp, err := http.DefaultClient.Do(req)

$response = file_get_contents(
    "https://apis.newssearchapi.com/v1/publisher-icons/example-id"
);
$data = json_decode($response, true);

Try it

No key needed

GET/v1/publisher-icons/{domain}

Stuck or found a mistake?Email developer support