Consulta de empresa | Documentação da API DomScan

GET /v1/company

Parâmetros de Consulta

Parâmetro	Tipo	Descrição
domain obrigatório	string	Domínio da empresa que você deseja consultar (por exemplo, "stripe.com")

Campos de Resposta

Campo	Descrição
`company.name`	Nome oficial da empresa
`company.description`	Descrição da atividade
`social`	Links do LinkedIn, Twitter, Facebook

Casos de Utilização

Inteligência competitiva
Pesquisa de fornecedores e parceiros

Pedido de Exemplo

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/company?domain=stripe.com"

Resposta de Exemplo

{
                "domain": "stripe.com",
                "company": {
                "name": "Stripe",
                "legal_name": null,
                "description": "Financial infrastructure for the internet.",
                "founded_year": null,
                "industry": null,
                "employee_count_range": null,
                "type": null
                },
                "location": {
                "headquarters": null
                },
                "social": {
                "linkedin": "https://linkedin.com/company/stripe",
                "twitter": "https://twitter.com/stripe",
                "facebook": null,
                "github": null
                },
                "tech": {
                "email_provider": "Google Workspace",
                "website_technologies": []
                },
                "confidence": 0.65
                }

GET /v1/identity-assets

Parâmetros de Consulta

Parâmetro	Tipo	obrigatório
domain	string	obrigatório
skip_cache	string Valores permitidos `1`	opcional

Campos de Resposta

Campo	Tipo
`domain`	string
`website_url`	string
`fetch_state`	string
`organization_name`	string \| null
`assets`	object
`assets.logo_url`	string \| null
`assets.logo_kind`	string \| null
`assets.logo_source`	string \| null
`assets.logo_verification`	string \| null
`assets.favicon_url`	string \| null
`assets.touch_icon_url`	string \| null
`assets.preview_image_url`	string \| null
`assets.manifest_url`	string \| null
`assets.theme_color`	string \| null
`assets.candidates[]`	object[]
`assets.candidates[]`	object
`assets.candidates[].url`	string
`assets.candidates[].kind`	string
`assets.candidates[].source`	string
`assets.candidates[].type`	string \| null
`assets.candidates[].sizes`	string \| null
`assets.candidates[].score`	integer
`assets.candidates[].confidence`	string
`social_profiles[]`	object[]
`social_profiles[]`	object
`social_profiles[].platform`	string
`social_profiles[].type`	string
`social_profiles[].handle`	string \| null
`social_profiles[].url`	string
`social_profiles[].source`	string
`social_profiles[].confidence`	string
`confidence`	number
`evidence[]`	string[]
`meta`	object
`meta.checked_at`	string
`meta.cached`	boolean
`meta.fetch_transport`	string
`meta.fetch_error`	string

Pedido de Exemplo

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

Resposta de Exemplo

{
  "domain": "example.com",
  "website_url": "https://example.com",
  "fetch_state": "ok",
  "assets": {
    "logo_url": "https://example.com",
    "logo_kind": "logo",
    "logo_source": "public_data",
    "logo_verification": "verified",
    "favicon_url": "https://example.com",
    "touch_icon_url": "https://example.com",
    "preview_image_url": "https://example.com",
    "manifest_url": "https://example.com",
    "theme_color": "example",
    "candidates": [
      {
        "url": "https://example.com",
        "kind": "example",
        "source": "public_data",
        "type": "domain",
        "sizes": "example",
        "score": 85,
        "confidence": "high"
      }
    ]
  },
  "social_profiles": [
    {
      "platform": "github",
      "type": "social",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high",
      "handle": "example"
    }
  ],
  "confidence": 0.85,
  "evidence": [
    "example"
  ],
  "meta": {
    "checked_at": "2026-08-27T12:00:00Z",
    "cached": false,
    "fetch_transport": "worker",
    "fetch_error": "timeout"
  },
  "organization_name": "example"
}

POST /v1/identity-assets/bulk

Parâmetros do Corpo

Parâmetro	Tipo	obrigatório
domains	string[]	obrigatório

Campos de Resposta

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.type`	string
`results[].error.error.message`	string
`results[].error.error.status`	integer
`results[].error.error.retryable`	boolean
`results[].error.error.request_id`	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.unknown`	integer
`meta.max_items`	integer
`meta.credits_per_item`	integer
`meta.duration_ms`	integer

Pedido de Exemplo

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

Resposta de Exemplo

{
  "results": [
    {
      "input": "example",
      "data": {},
      "error": {
        "error": {
          "code": "INVALID_DOMAIN",
          "type": "authentication_error",
          "message": "Invalid domain format",
          "status": 400,
          "retryable": false,
          "request_id": "request-id",
          "docs_url": "/docs#parameters",
          "suggestion": "example",
          "details": {},
          "retry_after": 300
        }
      }
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "unknown": 1,
    "max_items": 10,
    "credits_per_item": 2,
    "duration_ms": 1
  }
}

GET /v1/identity-resolution

Parâmetros de Consulta

Parâmetro	Tipo	obrigatório
domain	string	obrigatório
skip_cache	string Valores permitidos `1`	opcional

Campos de Resposta

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
`meta.fetch_error`	string

Pedido de Exemplo

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

Resposta de Exemplo

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

POST /v1/identity-resolution/bulk

Parâmetros do Corpo

Parâmetro	Tipo	obrigatório
domains	string[]	obrigatório

Campos de Resposta

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.type`	string
`results[].error.error.message`	string
`results[].error.error.status`	integer
`results[].error.error.retryable`	boolean
`results[].error.error.request_id`	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.unknown`	integer
`meta.max_items`	integer
`meta.credits_per_item`	integer
`meta.duration_ms`	integer

Pedido de Exemplo

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"
  ]
}'

Resposta de Exemplo

{
  "results": [
    {
      "input": "example",
      "data": {},
      "error": {
        "error": {
          "code": "INVALID_DOMAIN",
          "type": "authentication_error",
          "message": "Invalid domain format",
          "status": 400,
          "retryable": false,
          "request_id": "request-id",
          "docs_url": "/docs#parameters",
          "suggestion": "example",
          "details": {},
          "retry_after": 300
        }
      }
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "unknown": 1,
    "max_items": 10,
    "credits_per_item": 2,
    "duration_ms": 1
  }
}

GET /v1/url-intelligence

Parâmetros de Consulta

Parâmetro	Tipo	obrigatório
url	string	obrigatório
skip_cache	string Valores permitidos `1`	opcional

Campos de Resposta

Campo	Tipo
`requested_url`	string
`final_url`	string
`status`	integer
`fetch_state`	string
`content_type`	string \| null
`redirects`	integer
`title`	string \| null
`description`	string \| null
`canonical_url`	string \| null
`language`	string \| null
`favicon_url`	string \| null
`preview_image_url`	string \| null
`manifest_url`	string \| null
`theme_color`	string \| null
`open_graph`	object
`twitter_card`	object
`structured_data`	object
`structured_data.types[]`	string[]
`structured_data.items`	integer
`structured_data.parse_errors`	integer
`robots`	object
`robots.meta[]`	string[]
`robots.header[]`	string[]
`robots.indexable`	boolean \| null
`security_headers`	object
`links`	object
`links.total`	integer
`links.internal`	integer
`links.external`	integer
`social_profiles[]`	object[]
`social_profiles[]`	object
`social_profiles[].platform`	string
`social_profiles[].type`	string
`social_profiles[].handle`	string \| null
`social_profiles[].url`	string
`social_profiles[].source`	string
`social_profiles[].confidence`	string
`contacts`	object
`contacts.emails[]`	string[]
`contacts.phones[]`	string[]
`meta`	object
`meta.checked_at`	string
`meta.cached`	boolean
`meta.fetch_transport`	string
`meta.fetch_error`	string

Pedido de Exemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/url-intelligence?url=https%3A%2F%2Fexample.com&skip_cache=1"

Resposta de Exemplo

{
  "requested_url": "https://example.com",
  "final_url": "https://example.com",
  "status": 1,
  "fetch_state": "ok",
  "open_graph": {},
  "twitter_card": {},
  "structured_data": {
    "types": [
      "example"
    ],
    "items": 1,
    "parse_errors": 1
  },
  "robots": {
    "meta": [
      "example"
    ],
    "header": [
      "example"
    ],
    "indexable": false
  },
  "links": {
    "total": 1,
    "internal": 1,
    "external": 1
  },
  "social_profiles": [
    {
      "platform": "github",
      "type": "social",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high",
      "handle": "example"
    }
  ],
  "contacts": {
    "emails": [
      "[email protected]",
      "[email protected]"
    ],
    "phones": [
      "example"
    ]
  },
  "meta": {
    "checked_at": "2026-08-27T12:00:00Z",
    "cached": false,
    "fetch_transport": "worker",
    "fetch_error": "timeout"
  },
  "content_type": "domain",
  "redirects": 1,
  "title": "example",
  "description": "example",
  "canonical_url": "https://example.com",
  "language": "en",
  "favicon_url": "https://example.com",
  "preview_image_url": "https://example.com",
  "manifest_url": "https://example.com",
  "theme_color": "example",
  "security_headers": {}
}

POST /v1/url-intelligence/bulk

Parâmetros do Corpo

Parâmetro	Tipo	obrigatório
urls	string[]	obrigatório

Campos de Resposta

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.type`	string
`results[].error.error.message`	string
`results[].error.error.status`	integer
`results[].error.error.retryable`	boolean
`results[].error.error.request_id`	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.unknown`	integer
`meta.max_items`	integer
`meta.credits_per_item`	integer
`meta.duration_ms`	integer

Pedido de Exemplo

curl -X POST "https://domscan.net/v1/url-intelligence/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "urls": [
    "https://example.com",
    "https://github.com/about"
  ]
}'

Resposta de Exemplo

{
  "results": [
    {
      "input": "example",
      "data": {},
      "error": {
        "error": {
          "code": "INVALID_DOMAIN",
          "type": "authentication_error",
          "message": "Invalid domain format",
          "status": 400,
          "retryable": false,
          "request_id": "request-id",
          "docs_url": "/docs#parameters",
          "suggestion": "example",
          "details": {},
          "retry_after": 300
        }
      }
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "unknown": 1,
    "max_items": 10,
    "credits_per_item": 2,
    "duration_ms": 1
  }
}