Segurança e confiança · Produto DomScan

API de Certificados SSL

Obtenha informações de certificado SSL incluindo emissor, validade e classificação de segurança.

O que você recebe

Obtenha informações de certificado SSL incluindo emissor, validade e classificação de segurança.

SíncronoEm loteRESTMCPSDKFerramenta interativa

Escolha este produto quando

Para quem é

Use verificações passivas limitadas para enriquecer triagem e investigação, não para substituir testes autorizados ou análise humana.

Escolha este produto quando

Escolha para inspecionar evidências públicas de certificados TLS, validade, nomes e sinais relacionados à cadeia quando disponíveis.

O que você recebe

Obtenha informações de certificado SSL incluindo emissor, validade e classificação de segurança.

Endpoints

Veja o que cada endpoint aceita e retorna, seus modos e seus limites antes de integrar.

GET /v1/certificates Ver referência da API
POST /v1/certificates/bulk Ver referência da API
GET /v1/ssl/deep-scan Ver referência da APILer o guia
GET /v1/ssl/expiring Ver referência da APILer o guia

Créditos e autenticação

1-10 Autenticação obrigatória. Consulte a referência da API para ver o custo exato, incluindo eventuais preços por item.

Operação de exemplo

Use operações documentadas para coletar, avaliar, enriquecer, verificar, comparar, proteger ou monitorar evidências públicas.

GET /v1/certificates Créditos: 2

Parâmetros de consulta

Parâmetro Tipo obrigatório
domain string obrigatório
include_subdomains boolean
Padrão true
opcional
include_expired boolean
Padrão false
opcional
limit integer
Padrão 100
opcional
cursor string opcional

Campos da resposta

Campo Tipo
has_more boolean
next_cursor string | null
cache_age_s integer
domain string
certificates[] object[]
certificates[] object
certificates[].id string
certificates[].issuer object
certificates[].common_name string
certificates[].san[] string[]
certificates[].not_before string
certificates[].not_after string
certificates[].is_expired boolean
certificates[].is_wildcard boolean
certificates[].fingerprint_sha256 string
summary object
summary.total_found integer
summary.returned integer
summary.unique_subdomains integer
summary.issuers[] string[]
summary.earliest_cert string | null
summary.latest_cert string | null
pagination object
pagination.limit integer
pagination.offset integer
pagination.returned integer
pagination.total integer
pagination.has_more boolean
pagination.next_cursor string | null
intelligence_summary object
intelligence_summary.data_source string
intelligence_summary.ct_log_sources[] string[]
intelligence_summary.source_count integer
intelligence_summary.cache_status string
intelligence_summary.returned_count integer
intelligence_summary.total_found integer
intelligence_summary.truncated boolean
intelligence_summary.limit integer
intelligence_summary.include_subdomains boolean
intelligence_summary.include_expired boolean
intelligence_summary.unique_name_count integer
intelligence_summary.unique_subdomains integer
intelligence_summary.issuer_count integer
intelligence_summary.wildcard_cert_count integer
intelligence_summary.active_cert_count integer
intelligence_summary.expired_cert_count integer
intelligence_summary.expiring_within_30_days_count integer
intelligence_summary.earliest_cert string | null
intelligence_summary.latest_cert string | null
intelligence_summary.latest_expiry string | null
intelligence_summary.has_more boolean
intelligence_summary.next_cursor string | null
intelligence_summary.warning_code string | null
meta object

Exemplo de requisição

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example"
const response = await fetch("https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Exemplo de resposta

{
  "domain": "example.com",
  "certificates": [
    {
      "id": "16234550871",
      "issuer": {
        "name": "R11",
        "organization": "Let's Encrypt"
      },
      "common_name": "www.example.com",
      "san": [
        "example.com",
        "www.example.com"
      ],
      "not_before": "2026-09-14T08:12:44",
      "not_after": "2026-12-13T08:12:43",
      "is_expired": false,
      "is_wildcard": false
    },
    {
      "id": "16198877412",
      "issuer": {
        "name": "R11",
        "organization": "Let's Encrypt"
      },
      "common_name": "api.example.com",
      "san": [
        "api.example.com"
      ],
      "not_before": "2026-08-20T14:03:10",
      "not_after": "2026-11-18T14:03:09",
      "is_expired": false,
      "is_wildcard": false
    }
  ],
  "summary": {
    "total_found": 14,
    "returned": 2,
    "unique_subdomains": 3,
    "issuers": [
      "Let's Encrypt"
    ],
    "earliest_cert": "2026-08-20T14:03:10",
    "latest_cert": "2026-09-14T08:12:44"
  },
  "pagination": {
    "limit": 2,
    "offset": 0,
    "returned": 2,
    "total": 14,
    "has_more": true,
    "next_cursor": "2"
  },
  "intelligence_summary": {
    "data_source": "crt.sh",
    "ct_log_sources": [
      "crt.sh"
    ],
    "source_count": 1,
    "cache_status": "live",
    "returned_count": 2,
    "total_found": 14,
    "truncated": true,
    "limit": 2,
    "include_subdomains": true,
    "include_expired": false,
    "unique_name_count": 3,
    "unique_subdomains": 3,
    "issuer_count": 1,
    "wildcard_cert_count": 0,
    "active_cert_count": 2,
    "expired_cert_count": 0,
    "expiring_within_30_days_count": 0,
    "earliest_cert": "2026-08-20T14:03:10",
    "latest_cert": "2026-09-14T08:12:44",
    "latest_expiry": "2026-12-13T08:12:43",
    "has_more": true,
    "next_cursor": "2",
    "warning_code": null
  },
  "meta": {
    "source": "crt.sh",
    "ct_log_sources": [
      "crt.sh"
    ],
    "query_time_ms": 1240,
    "cached": false,
    "page": {
      "limit": 2,
      "offset": 0,
      "returned": 2,
      "total": 14,
      "has_more": true,
      "next_cursor": "2"
    },
    "served_by": "pop=MAD country=ES"
  }
}

Códigos de status HTTP

  • 200 OK
  • 400 Pedido inválido
  • 401 Não autorizado
  • 402 Pagamento necessário
  • 429 Demasiados pedidos
  • 503 Serviço indisponível
  • 504 Tempo limite do gateway

Perguntas frequentes

Onde encontro a referência de solicitação e resposta de Certificados SSL?

Use a referência da API de Certificados SSL para revisar parâmetros, campos de resposta, exemplos, códigos de status e modos de operação compatíveis.

Como devo interpretar resultados desconhecidos ou incompletos de Certificados SSL?

Desconhecido ou parcial significa que não conseguimos confirmar totalmente o resultado. Considere o status, a confiança, a atualidade e quaisquer limites antes de agir.

Como Certificados SSL é cobrado?

O preço depende da verificação e do modo escolhido. A referência da API mostra o custo atual em créditos, se você precisa de uma chave de API e eventuais preços por item.

Usado por pessoas nestas empresas

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse