Referencia de API

API de Resolución de identidad en Internet

Resuelve el dominio de una empresa en las identidades públicas declaradas explícitamente por su sitio web. Usa esta referencia para elegir una operación e integrar su contrato de respuesta documentado.

Ver página del producto

Operaciones

GET /v1/identity-resolution Ver referencia de API

POST /v1/identity-resolution/bulk Ver referencia de API

GET `/v1/identity-resolution`

Operación: resolveInternetIdentity Créditos y autenticación: 2 Autenticación obligatoria

GET /v1/identity-resolution

Parámetros de consulta

Parámetro	Tipo	obligatorio
domain	string	obligatorio
skip_cache	string Valores permitidos `1`	opcional

Campos de respuesta

Campo	Tipo
`query`	string
`canonical_domain`	string
`website_url`	string
`fetch_state`	string
`organization`	object
`organization.name`	string \| null
`organization.description`	string \| null
`identities[]`	object[]
`identities[]`	object
`identities[].platform`	string
`identities[].type`	string
`identities[].handle`	string \| null
`identities[].url`	string
`identities[].source`	string
`identities[].confidence`	string
`contacts`	object
`contacts.emails[]`	string[]
`contacts.phones[]`	string[]
`confidence`	number
`evidence`	object
`evidence.declared_identity_count`	integer
`evidence.high_confidence_count`	integer
`evidence.medium_confidence_count`	integer
`evidence.sources[]`	string[]
`meta`	object
`meta.checked_at`	string
`meta.cached`	boolean
`meta.fetch_transport`	string

Solicitud de ejemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-resolution?domain=example.com&skip_cache=example.com"

Respuesta de ejemplo

{
  "query": "string",
  "canonical_domain": "example.com",
  "website_url": "https://example.com",
  "fetch_state": "ok",
  "organization": {
    "name": "string",
    "description": "198.51.100.10"
  },
  "identities": [
    {
      "platform": "github",
      "type": "social",
      "handle": "example",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high"
    }
  ],
  "contacts": {
    "emails": [
      "[email protected]"
    ],
    "phones": [
      "string"
    ]
  },
  "confidence": 1,
  "evidence": {
    "declared_identity_count": 1,
    "high_confidence_count": 1,
    "medium_confidence_count": 1,
    "sources": [
      "string"
    ]
  },
  "meta": {
    "checked_at": "2026-04-15T12:00:00Z",
    "cached": true,
    "fetch_transport": "worker"
  }
}

POST `/v1/identity-resolution/bulk`

Operación: bulkResolveInternetIdentity Créditos y autenticación: 2 Autenticación obligatoria

POST /v1/identity-resolution/bulk

Parámetros del cuerpo

Parámetro	Tipo	obligatorio
domains	string[]	obligatorio

Campos de respuesta

Campo	Tipo
`results[]`	object[]
`results[]`	object
`results[].input`	string
`results[].data`	object
`results[].error`	object
`results[].error.error`	object
`results[].error.error.code`	string
`results[].error.error.message`	string
`results[].error.error.suggestion`	string
`results[].error.error.details`	object
`results[].error.error.retry_after`	integer
`results[].error.error.docs_url`	string
`meta`	object
`meta.total`	integer
`meta.succeeded`	integer
`meta.failed`	integer
`meta.max_items`	integer
`meta.credits_per_item`	integer
`meta.duration_ms`	integer

Solicitud de ejemplo

curl -X POST "https://domscan.net/v1/identity-resolution/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domains": [
    "stripe.com",
    "github.com"
  ]
}'

Respuesta de ejemplo

{
  "results": [
    {
      "input": "string",
      "data": {},
      "error": {
        "error": {
          "code": "INVALID_DOMAIN",
          "message": "Invalid domain format",
          "suggestion": "string",
          "details": {},
          "retry_after": 300,
          "docs_url": "/docs#parameters"
        }
      }
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "max_items": 10,
    "credits_per_item": 2,
    "duration_ms": 1
  }
}

Recursos de referencia

OpenAPI 3.0 Postman MCP