Tożsamość i weryfikacja

API do wyszukiwania awatarów i logo

Pokaż prawdziwą twarz lub logo przy każdym użytkowniku, leadzie i firmie. Wyślij adres e-mail, nazwę użytkownika lub domenę i otrzymaj najlepszy zweryfikowany obraz, jego pochodzenie oraz uczciwą odpowiedź, gdy go nie ma.

Zobacz dokumentację Poznaj wszystkie API

Punkty końcowe Aktywny

GET /v1/avatar

Przykładowe żądanie

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Przykładowa odpowiedź 200 OK

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates"
...

Przykładowe żądanie GET /v1/avatar

Kluczowe funkcje 4

Często zadawane pytania 4

Kody statusu HTTP 200 / 400 / 401 / 402 / 429

Kategoria Tożsamość i weryfikacja

Punkty końcowe 1

Kluczowe funkcje 4

Często zadawane pytania 4

Używany przez ludzi w tych firmach

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

OpenAPI Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

1000 Darmowy limit

Zacznij od 1 000 bezpłatnych kredytów w każdym miesiącu kalendarzowym według UTC. W razie potrzeby wybierz opcjonalny plan miesięczny lub kup pakiet jednorazowy.

Co ta API pomaga wdrożyć

Użyj tej strony jako briefu produkcyjnego: endpointy, przykłady, kształt odpowiedzi i elementy workflow potrzebne do podłączenia DomScan do produktu.

Workflow produktu

Osadzaj sprawdzanie domen, DNS intelligence, sygnały ryzyka lub enrichment w onboardingu, wyszukiwarce i narzędziach wewnętrznych.

Automatyzacja analityków

Zastąp powtarzalne ręczne lookupy zadaniami cyklicznymi, alertami i odtwarzalnymi krokami dochodzenia.

Czyste dane JSON

Używaj przewidywalnych pól, udokumentowanych kodów statusu i kosztów kredytów zamiast scrapować strony dostawców.

AI i narzędzia ops

Zasilaj agentów, dashboardy, playbooki SOAR i CRMy przez OpenAPI, SDK, Postman lub MCP.

Workflow integracji

Prosta ścieżka od pierwszego requestu do powtarzalnego użycia produkcyjnego.

Uwierzytelnij raz

Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.

Odpytuj z przykładami

Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.

Operuj i monitoruj

Używaj kodów statusu, kosztów kredytów i pól odpowiedzi do retries, logów i alertów.

Zestaw developerski

Przejdź z tej strony do dokumentacji machine-readable, kolekcji requestów, SDK lub narzędzi agentowych.

Schemat OpenAPI

Generuj klientów lub sprawdzaj każdy kształt requestu i odpowiedzi.

Kolekcja Postman

Importuj gotowe requesty do testów manualnych i przekazania zespołowi.

SDK i CLI

Używaj utrzymywanych pakietów i workflow command-line zamiast pisać boilerplate.

Integracja MCP

Udostępniaj domain intelligence agentom AI i wewnętrznym asystentom.

Mapa parametrów i odpowiedzi

Przejrzyj inputy, pola outputu i kody statusu przed podłączeniem endpointu do klienta.

Parametry requestu

Parametr

emailusernameplatformdomain

Pola odpowiedzi

Przykładowa odpowiedź

inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates

Zakres statusów

Kody statusu HTTP

200400401402429

Punkty końcowe

GET /v1/avatar

Kredyty: 2Uwierzytelnianie: Uwierzytelnienie required

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

OpenAPI Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

1000 Darmowy limit

Zacznij od 1 000 bezpłatnych kredytów w każdym miesiącu kalendarzowym według UTC. W razie potrzeby wybierz opcjonalny plan miesięczny lub kup pakiet jednorazowy.

Kluczowe funkcje

E-mail, nazwa użytkownika lub domena

Adresy e-mail są dopasowywane do publicznych usług awatarów oraz logo firmy z ich domeny pocztowej. Nazwy użytkowników są sprawdzane w GitHub, Bluesky, Mastodon i Keybase. Domeny zwracają logo strony internetowej.

Tylko zweryfikowane obrazy

Każdy zwrócony obraz jest pobierany i sprawdzany pod kątem tego, czy naprawdę jest obrazem. Strony błędów, uszkodzone linki i domyślne obrazy zastępcze nigdy nie są zwracane.

Dowody dla każdego źródła

Każde źródło zgłasza present, absent lub unknown wraz z przyczyną, dzięki czemu brak zdjęcia nigdy nie jest mylony ze źródłem, które nie odpowiedziało.

Aktualne dane, gdy ich potrzebujesz

Wyniki są ponownie wykorzystywane przez kilka godzin. Wyślij max_age, aby ustawić maksymalny wiek zapisanej odpowiedzi, lub max_age=0, aby wykonać nowe sprawdzenie.

Przykładowe żądanie

GET /v1/avatar?username=octocat bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Przykładowa odpowiedź

200 OK json

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates": [
    {
      "source": "github",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://avatars.githubusercontent.com/u/583231?v=4",
      "verified": true,
      "content_type": "image/png",
      "profile_url": "https://github.com/octocat",
      "may_be_generated": true
    },
    {
      "source": "bluesky",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
      "verified": true,
      "content_type": "image/jpeg",
      "profile_url": "https://bsky.app/profile/octocat.bsky.social"
    },
    { "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
  ],
  "status": "present",
  "checked_at": "2026-11-02T10:00:00.000Z"
}

Często zadawane pytania

Jakie źródła są sprawdzane?

Dla adresu e-mail: Gravatar, Libravatar i logo BIMI domeny pocztowej firmy. Dla nazwy użytkownika: GitHub, Bluesky, Mastodon i Keybase albo tylko wybrana przez Ciebie platforma. Dla domeny: logo lub ikona publikowane przez stronę oraz jej logo BIMI.

Co oznacza absent?

Każde źródło jasno odpowiedziało, że nie ma zdjęcia: brak konta, konto bez zdjęcia albo brak opublikowanego logo. Jeśli któreś źródło było zablokowane, wolne lub niejednoznaczne, wynikiem jest zamiast tego unknown.

Dlaczego zdjęcie z GitHub może być oznaczone jako prawdopodobnie wygenerowane?

GitHub nadaje kontom bez przesłanego zdjęcia wygenerowany wzór i nie podaje, jaki rodzaj obrazu ma dane konto. Taki obraz nigdy nie jest zwracany jako awatar. Jest wymieniany wraz z innymi źródłami i oznaczany, a jeśli to jedyny znaleziony obraz, wynikiem jest unknown.

Ile kredytów to kosztuje?

Dwa kredyty za jedno wyszukiwanie, niezależnie od liczby sprawdzonych źródeł. Wyniki unknown są zwracane.

Narzędzia pokrewne i zasoby

Kody statusu HTTP

Oto kody statusu HTTP, które należy obsługiwać, aby odróżnić udane odpowiedzi, problemy z uwierzytelnianiem, kredyty, limity żądań, brakujące dane i błędy usług nadrzędnych.

OK 200

Żądanie zakończone pomyślnie

Nieprawidłowe żądanie 400

Nieprawidłowe parametry

Nieautoryzowany 401

Brakuje klucza API lub sesji albo są one nieprawidłowe.

Wymagana płatność 402

Za mało kredytów, aby wykonać to żądanie.

Zbyt wiele żądań 429

Przekroczono limit żądań

Znajdź awatar

Zacznij za darmo Zobacz dokumentację