> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/tr/docs/products/domain-profile

# Domain Profili API ürünü

WHOIS, DNS ve hosting bilgilerini de dahil olmak üzere bir alanın kapsamlı profilini alın. Doğru uç noktayı seçmek ve tam olarak ne döndürdüğünü görmek için bu referansı kullanın.

[Ürün sayfasını görüntüle](https://domscan.net/tr/domain-profile-api)

## İşlemler

GET `/v1/profile` [API referansını görüntüle](https://domscan.net/tr/docs/products/domain-profile#getDomainProfile)

POST `/v1/profile/bulk` [API referansını görüntüle](https://domscan.net/tr/docs/products/domain-profile#bulkGetDomainProfile)

GET `/v1/overview` [API referansını görüntüle](https://domscan.net/tr/docs/products/domain-profile#getDomainOverview)

GET `/v1/popularity` [API referansını görüntüle](https://domscan.net/tr/docs/products/domain-profile#getDomainPopularity)

GET `/v1/popularity/history` [API referansını görüntüle](https://domscan.net/tr/docs/products/domain-profile#getDomainPopularityHistory)

## GET `/v1/profile`

İşlem: `getDomainProfile`
Krediler ve kimlik doğrulama: 3
Kimlik doğrulama gerekli

GET /v1/profile Kredi: 3

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domain | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `domain` | string |
| `registered` | boolean \| null |
| `registrar` | string \| null |
| `registrar_url` | string \| null |
| `registrar_iana_id` | string \| null |
| `created_date` | string \| null |
| `updated_date` | string \| null |
| `expiry_date` | string \| null |
| `age_days` | integer |
| `days_until_expiry` | integer |
| `nameservers[]` | string[] |
| `status[]` | string[] |
| `dnssec` | boolean |
| `events[]` | object[] |
| `events[]` | object |
| `events[].action` | string |
| `events[].date` | string |
| `contacts` | object |
| `contacts.registrant_name` | string \| null |
| `contacts.registrant_org` | string \| null |
| `contacts.registrant_country` | string \| null |
| `contacts.admin_email` | string \| null |
| `contacts.tech_email` | string \| null |
| `privacy` | object |
| `privacy.is_private` | boolean |
| `privacy.privacy_service` | string \| null |
| `raw_rdap_link` | string \| null |
| `source_summary` | object |
| `source_summary.source` | string |
| `source_summary.authoritative_source` | string |
| `source_summary.cache_status` | string |
| `source_summary.fallback_used` | boolean |
| `source_summary.relay_configured` | boolean |
| `source_summary.registered` | boolean \| null |
| `source_summary.status_count` | integer |
| `source_summary.nameserver_count` | integer |
| `source_summary.event_count` | integer |
| `source_summary.date_fields_present[]` | string[] |
| `source_summary.contact_field_count` | integer |
| `source_summary.privacy_detected` | boolean |
| `checked_at` | string |
| `query_time_ms` | integer |
| `meta` | object |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/profile?domain=example.com"
```

```javascript
const response = await fetch("https://domscan.net/v1/profile?domain=example.com", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/profile?domain=example.com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/profile?domain=example.com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/profile?domain=example.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "domain": "example.com",
  "registered": true,
  "registrar": "Example Registrar, Inc.",
  "registrar_url": "https://registrar.example.net",
  "registrar_iana_id": "9999",
  "created_date": "2019-03-11T14:22:08Z",
  "updated_date": "2026-03-10T09:41:55Z",
  "expiry_date": "2027-03-11T14:22:08Z",
  "age_days": 2769,
  "days_until_expiry": 153,
  "status": [
    "client transfer prohibited"
  ],
  "nameservers": [
    "ns1.example.net",
    "ns2.example.net"
  ],
  "dnssec": false,
  "events": [
    {
      "action": "registration",
      "date": "2019-03-11T14:22:08Z"
    },
    {
      "action": "expiration",
      "date": "2027-03-11T14:22:08Z"
    },
    {
      "action": "last changed",
      "date": "2026-03-10T09:41:55Z"
    }
  ],
  "contacts": {
    "registrant_name": null,
    "registrant_org": null,
    "registrant_country": null,
    "admin_email": null,
    "tech_email": null
  },
  "privacy": {
    "is_private": false,
    "privacy_service": null
  },
  "raw_rdap_link": "https://rdap.example.net/domain/example.com",
  "source_summary": {
    "source": "rdap",
    "authoritative_source": "rdap",
    "cache_status": "miss",
    "fallback_used": false,
    "relay_configured": true,
    "registered": true,
    "status_count": 1,
    "nameserver_count": 2,
    "event_count": 3,
    "date_fields_present": [
      "created_date",
      "updated_date",
      "expiry_date"
    ],
    "contact_field_count": 0,
    "privacy_detected": false
  },
  "checked_at": "2026-10-09T10:15:30.000Z",
  "query_time_ms": 386,
  "meta": {
    "served_by": "pop=MAD country=ES",
    "cached": false
  }
}
```

#### HTTP durum kodları

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

## POST `/v1/profile/bulk`

İşlem: `bulkGetDomainProfile`
Krediler ve kimlik doğrulama: 3
Kimlik doğrulama gerekli

POST /v1/profile/bulk Kredi: 3/item

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| dry_run | string İzin verilen değerler `true` | isteğe bağlı |

#### Gövde parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domains | string[] | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `results[]` | unknown[] |
| `meta` | object |
| `meta.total` | integer |
| `meta.succeeded` | integer |
| `meta.failed` | integer |
| `meta.max_items` | integer |
| `meta.credits_per_item` | integer |
| `meta.duration_ms` | integer |

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/profile/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domains": [
    "example.com",
    "cloudflare.com"
  ]
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/profile/bulk", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "domains": [
      "example.com",
      "cloudflare.com"
    ]
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.post(
    "https://domscan.net/v1/profile/bulk",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "domains": [
            "example.com",
            "cloudflare.com",
        ],
    },
)
print(response.json())
```

```go
package main

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

func main() {
	body := strings.NewReader(`{
	  "domains": [
	    "example.com",
	    "cloudflare.com"
	  ]
	}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/profile/bulk", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/profile/bulk")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "domains" => [
    "example.com",
    "cloudflare.com"
  ]
})

#### Örnek yanıt

```json
{
  "results": [
    {
      "input": "example",
      "data": {}
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "max_items": 10,
    "credits_per_item": 1,
    "duration_ms": 1
  }
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `409` HTTP 409
- `422` HTTP 422
- `429` Çok Fazla İstek

## GET `/v1/overview`

İşlem: `getDomainOverview`
Krediler ve kimlik doğrulama: 5
Kimlik doğrulama gerekli

GET /v1/overview Kredi: 5

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domain | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `domain` | string |
| `health` | object |
| `health.dns_ok` | boolean \| null |
| `health.https_ok` | boolean \| null |
| `dns` | object |
| `dns.has_a` | boolean \| null |
| `dns.has_aaaa` | boolean \| null |
| `dns.has_mx` | boolean \| null |
| `dns.nameservers[]` | string[] |
| `registration` | object |
| `registration.registered` | boolean \| null |
| `registration.registrar` | string \| null |
| `registration.created_date` | string \| null |
| `registration.expiry_date` | string \| null |
| `registration.age_days` | integer \| null |
| `registration.days_until_expiry` | integer \| null |
| `registration.dnssec` | boolean \| null |
| `reputation` | object |
| `reputation.score` | number \| null |
| `reputation.grade` | string \| null |
| `popularity` | object |
| `popularity.rank` | integer \| null |
| `popularity.bucket` | string \| null |
| `component_freshness` | object |
| `component_freshness.cache_status` | string |
| `component_freshness.checked_at` | string |
| `component_freshness.component_count` | integer |
| `component_freshness.fresh_component_count` | integer |
| `component_freshness.degraded_component_count` | integer |
| `component_freshness.components` | object |
| `component_freshness.components.health` | object |
| `component_freshness.components.health.source` | string |
| `component_freshness.components.health.state` | string |
| `component_freshness.components.health.checked_at` | string |
| `component_freshness.components.health.evidence_count` | integer |
| `component_freshness.components.health.reason` | string \| null |
| `component_freshness.components.dns` | object |
| `component_freshness.components.dns.source` | string |
| `component_freshness.components.dns.state` | string |
| `component_freshness.components.dns.checked_at` | string |
| `component_freshness.components.dns.evidence_count` | integer |
| `component_freshness.components.dns.reason` | string \| null |
| `component_freshness.components.registration` | object |
| `component_freshness.components.registration.source` | string |
| `component_freshness.components.registration.state` | string |
| `component_freshness.components.registration.checked_at` | string |
| `component_freshness.components.registration.evidence_count` | integer |
| `component_freshness.components.registration.reason` | string \| null |
| `component_freshness.components.reputation` | object |
| `component_freshness.components.reputation.source` | string |
| `component_freshness.components.reputation.state` | string |
| `component_freshness.components.reputation.checked_at` | string |
| `component_freshness.components.reputation.evidence_count` | integer |
| `component_freshness.components.reputation.reason` | string \| null |
| `component_freshness.components.popularity` | object |
| `component_freshness.components.popularity.source` | string |
| `component_freshness.components.popularity.state` | string |
| `component_freshness.components.popularity.checked_at` | string |
| `component_freshness.components.popularity.evidence_count` | integer |
| `component_freshness.components.popularity.reason` | string \| null |
| `query_time_ms` | integer |
| `checked_at` | string |
| `meta` | object |
| `meta.served_by` | string |
| `meta.cached` | boolean |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/overview?domain=example.com"
```

```javascript
const response = await fetch("https://domscan.net/v1/overview?domain=example.com", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/overview?domain=example.com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/overview?domain=example.com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/overview?domain=example.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "domain": "example.com",
  "health": {
    "dns_ok": true,
    "https_ok": true
  },
  "dns": {
    "has_a": true,
    "has_aaaa": true,
    "has_mx": false,
    "nameservers": [
      "ns1.example.net",
      "ns2.example.net"
    ]
  },
  "registration": {
    "registered": true,
    "registrar": "Example Registrar, Inc.",
    "created_date": "2019-03-11T14:22:08Z",
    "expiry_date": "2027-03-11T14:22:08Z",
    "age_days": 2769,
    "days_until_expiry": 153,
    "dnssec": false
  },
  "reputation": {
    "score": 82,
    "grade": "A"
  },
  "popularity": {
    "rank": 18452,
    "bucket": "top-100k"
  },
  "component_freshness": {
    "cache_status": "miss",
    "checked_at": "2026-10-09T10:15:30.000Z",
    "component_count": 5,
    "fresh_component_count": 5,
    "degraded_component_count": 0,
    "components": {
      "health": {
        "source": "quick_health",
        "state": "fresh",
        "checked_at": "2026-10-09T10:15:30.000Z",
        "evidence_count": 2
      },
      "dns": {
        "source": "dns",
        "state": "fresh",
        "checked_at": "2026-10-09T10:15:30.000Z",
        "evidence_count": 4
      },
      "registration": {
        "source": "rdap",
        "state": "fresh",
        "checked_at": "2026-10-09T10:15:30.000Z",
        "evidence_count": 7
      },
      "reputation": {
        "source": "reputation",
        "state": "fresh",
        "checked_at": "2026-10-09T10:15:30.000Z",
        "evidence_count": 2
      },
      "popularity": {
        "source": "popularity",
        "state": "fresh",
        "checked_at": "2026-10-09T10:15:30.000Z",
        "evidence_count": 2
      }
    }
  },
  "query_time_ms": 1840,
  "checked_at": "2026-10-09T10:15:30.000Z",
  "meta": {
    "served_by": "pop=MAD country=ES",
    "cached": false
  }
}
```

#### HTTP durum kodları

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

## GET `/v1/popularity`

İşlem: `getDomainPopularity`
Krediler ve kimlik doğrulama: 2
Kimlik doğrulama gerekli

GET /v1/popularity Kredi: 2

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domain | string | gerekli |
| include_history | boolean Varsayılan `false` | isteğe bağlı |
| history_limit | integer Varsayılan `30` | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `domain` | string |
| `status` | string |
| `rank` | integer \| null |
| `bucket` | string |
| `source` | object |
| `source.id` | string |
| `source.url` | string |
| `source.list_date` | string \| null |
| `source.provenance` | object |
| `source.provenance.owner` | string |
| `source.provenance.source_url` | string |
| `source.provenance.methodology_url` | string |
| `source.provenance.access_method` | string |
| `source.provenance.cost` | string |
| `source.provenance.runtime_rate_limits` | string |
| `source.provenance.terms_status` | string |
| `source.provenance.expected_freshness` | string |
| `source.provenance.maintenance_risk` | string |
| `source.provenance.fallback_behavior` | string |
| `source.provenance.last_verified` | string |
| `freshness` | object |
| `freshness.cache_status` | string |
| `freshness.ttl_seconds` | integer |
| `checked_at` | string |
| `result_count` | integer \| null |
| `empty_result` | boolean |
| `history` | object |
| `history.collection` | string |
| `history.complete_daily_series` | boolean |
| `history.available` | boolean |
| `history.observations[]` | object[] |
| `history.observations[]` | object |
| `history.observations[].domain` | string |
| `history.observations[].rank` | integer \| null |
| `history.observations[].bucket` | string |
| `history.observations[].status` | string |
| `history.observations[].source` | string |
| `history.observations[].list_date` | string \| null |
| `history.observations[].observed_on` | string |
| `history.observations[].checked_at` | string |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30"
```

```javascript
const response = await fetch("https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "domain": "example.com",
  "status": "ranked",
  "rank": 18452,
  "bucket": "top-100k",
  "source": {
    "id": "tranco",
    "url": "https://tranco-list.eu/",
    "list_date": "2026-10-08",
    "provenance": {
      "owner": "Tranco research project",
      "source_url": "https://tranco-list.eu/",
      "methodology_url": "https://tranco-list.eu/methodology",
      "access_method": "public_domain_rank_api",
      "cost": "none",
      "runtime_rate_limits": "not_published_cached_and_bounded_by_domscan",
      "terms_status": "mixed_upstream_licenses_review_required_for_commercial_reuse",
      "expected_freshness": "daily",
      "maintenance_risk": "medium",
      "fallback_behavior": "return_unknown_without_inventing_or_reusing_an_unranked_result",
      "last_verified": "2026-08-02"
    }
  },
  "freshness": {
    "cache_status": "miss",
    "ttl_seconds": 86400
  },
  "checked_at": "2026-10-09T10:15:30.000Z",
  "result_count": 1,
  "empty_result": false,
  "history": {
    "collection": "lookup_driven",
    "complete_daily_series": false,
    "available": true,
    "observations": [
      {
        "domain": "example.com",
        "rank": 18452,
        "bucket": "top-100k",
        "status": "ranked",
        "source": "tranco",
        "list_date": "2026-10-08",
        "observed_on": "2026-10-09",
        "checked_at": "2026-10-09T10:15:30.000Z"
      },
      {
        "domain": "example.com",
        "rank": 18877,
        "bucket": "top-100k",
        "status": "ranked",
        "source": "tranco",
        "list_date": "2026-10-01",
        "observed_on": "2026-10-02",
        "checked_at": "2026-10-02T10:15:30.000Z"
      }
    ]
  }
}
```

#### HTTP durum kodları

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

## GET `/v1/popularity/history`

İşlem: `getDomainPopularityHistory`
Krediler ve kimlik doğrulama: 1
Kimlik doğrulama gerekli

GET /v1/popularity/history Kredi: 1

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domain | string | gerekli |
| limit | integer Varsayılan `30` | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `domain` | string |
| `collection` | string |
| `complete_daily_series` | boolean |
| `result_count` | integer |
| `empty_result` | boolean |
| `observations[]` | object[] |
| `observations[]` | object |
| `observations[].domain` | string |
| `observations[].rank` | integer \| null |
| `observations[].bucket` | string |
| `observations[].status` | string |
| `observations[].source` | string |
| `observations[].list_date` | string \| null |
| `observations[].observed_on` | string |
| `observations[].checked_at` | string |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/popularity/history?domain=example.com&limit=25"
```

```javascript
const response = await fetch("https://domscan.net/v1/popularity/history?domain=example.com&limit=25", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/popularity/history?domain=example.com&limit=25",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

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

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/popularity/history?domain=example.com&limit=25", 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))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/popularity/history?domain=example.com&limit=25")
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

```json
{
  "domain": "example.com",
  "collection": "lookup_driven",
  "complete_daily_series": false,
  "result_count": 1,
  "empty_result": false,
  "observations": [
    {
      "domain": "example.com",
      "rank": 1,
      "bucket": "top-100",
      "status": "ranked",
      "source": "tranco",
      "list_date": "2026-08-27",
      "observed_on": "2026-08-27",
      "checked_at": "2026-08-27T12:00:00Z"
    }
  ]
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `429` Çok Fazla İstek
- `500` Sunucu Hatası

## Referans kaynakları

[OpenAPI 3.0](https://domscan.net/v1/openapi.json)
[Postman](https://domscan.net/v1/postman.json)
[MCP](https://domscan.net/tr/mcp-domain-checker)
