API-Referenz

API für Unternehmenssuche

Suchen Sie nach Unternehmenssinformationen, die mit einer Domain verbunden sind. Nutzen Sie diese Referenz, um den passenden Endpunkt zu wählen und genau zu sehen, was er zurückgibt.

Operationen

GET /v1/company API-Referenz ansehen

GET /v1/company

Operation: getCompany Credits und Authentifizierung: 3 Authentifizierung erforderlich
GET /v1/company Credits: 3

Abfrageparameter

Parameter Typ erforderlich
domain string erforderlich

Antwortfelder

Feld Typ
domain string
company object
company.name string | null
company.legal_name string | null
company.description string | null
company.founded_year integer | null
company.industry string | null
company.employee_count_range string | null
company.type string | null
location object
social object
social.linkedin string | null
social.twitter string | null
social.facebook string | null
social.github string | null
tech object
tech.email_provider string | null
tech.website_technologies[] string[]
confidence number
evidence_summary object
evidence_summary.sources[] string[]
evidence_summary.source_count integer
evidence_summary.confidence number
evidence_summary.confidence_label string
evidence_summary.company_field_count integer
evidence_summary.social_profile_count integer
evidence_summary.email_provider_detected boolean
evidence_summary.website_technology_count integer
evidence_summary.cache_status string
meta object

Beispielanfrage

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/company?domain=example.com"
const response = await fetch("https://domscan.net/v1/company?domain=example.com", {
  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/company?domain=example.com",
    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/company?domain=example.com", 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/company?domain=example.com")
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))

Beispielantwort

{
  "domain": "example.com",
  "company": {
    "name": "Example Co",
    "legal_name": null,
    "description": "Example Co builds simple tools for small teams.",
    "founded_year": null,
    "industry": null,
    "employee_count_range": null,
    "type": null
  },
  "location": {
    "headquarters": null
  },
  "social": {
    "linkedin": "https://www.linkedin.com/company/example-co",
    "twitter": null,
    "facebook": null,
    "github": "https://github.com/example-co"
  },
  "tech": {
    "email_provider": "Google Workspace",
    "website_technologies": []
  },
  "confidence": 0.8,
  "evidence_summary": {
    "sources": [
      "meta_tags",
      "dns",
      "social_links"
    ],
    "source_count": 3,
    "confidence": 0.8,
    "confidence_label": "high",
    "company_field_count": 2,
    "social_profile_count": 2,
    "email_provider_detected": true,
    "website_technology_count": 0,
    "cache_status": "miss"
  },
  "meta": {
    "sources": [
      "meta_tags",
      "dns",
      "social_links"
    ],
    "query_time_ms": 1320,
    "cached": false
  }
}

HTTP-Statuscodes

  • 200 OK
  • 400 Ungültige Anfrage
  • 401 Nicht autorisiert
  • 402 Zahlung erforderlich
  • 429 Zu viele Anfragen

Referenzressourcen