API referansı

Şirket Araması API ürünü

Bir alan adıyla ilişkili şirket bilgilerini araştırın. Doğru uç noktayı seçmek ve tam olarak ne döndürdüğünü görmek için bu referansı kullanın.

İşlemler

GET /v1/company

İşlem: getCompany Krediler ve kimlik doğrulama: 3 Kimlik doğrulama gerekli
GET /v1/company Kredi: 3

Sorgu parametreleri

Parametre Tür gerekli
domain string gerekli

Yanıt alanları

Alan Tür
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

Örnek istek

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))

Örnek yanıt

{
  "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 durum kodları

  • 200 OK
  • 400 Hatalı İstek
  • 401 Yetkisiz
  • 402 Ödeme Gerekli
  • 429 Çok Fazla İstek

Referans kaynakları