Birleşik URL İstihbaratı API ürünü
Bir URL'den normalleştirilmiş sayfa meta verilerini, önizleme alanlarını, yapılandırılmış verileri ve herkese açık kimlik sinyallerini çıkarı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/url-intelligence
GET
/v1/url-intelligence
Kredi: 2
Sorgu parametreleri
| Parametre | Tür | gerekli |
|---|---|---|
| url | string | gerekli |
| skip_cache |
string
İzin verilen değerler
1
|
isteğe bağlı |
Yanıt alanları
| Alan | Tür |
|---|---|
cache_age_s |
integer |
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 |
author |
string | null |
publisher |
string | null |
published_at |
string | null |
modified_at |
string | null |
feeds[] |
object[] |
feeds[] |
object |
feeds[].url |
string |
feeds[].type |
string |
feeds[].title |
string | null |
oembed_url |
string | null |
video |
object |
video.url |
string |
video.type |
string | null |
video.width |
integer | null |
video.height |
integer | null |
video.source |
string |
audio |
object |
audio.url |
string |
audio.type |
string | null |
audio.source |
string |
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 |
Örnek istek
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/url-intelligence?url=https%3A%2F%2Fexample.com&skip_cache=1"const response = await fetch("https://domscan.net/v1/url-intelligence?url=https%3A%2F%2Fexample.com&skip_cache=1", {
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/url-intelligence?url=https%3A%2F%2Fexample.com&skip_cache=1",
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/url-intelligence?url=https%3A%2F%2Fexample.com&skip_cache=1", 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/url-intelligence?url=https%3A%2F%2Fexample.com&skip_cache=1")
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
{
"requested_url": "https://www.example.com/",
"final_url": "https://www.example.com/",
"status": 200,
"fetch_state": "ok",
"content_type": "text/html; charset=UTF-8",
"redirects": 0,
"title": "Example Co",
"description": "Example Co builds simple tools for small teams.",
"canonical_url": "https://www.example.com/",
"language": "en",
"favicon_url": "https://www.example.com/favicon.ico",
"preview_image_url": "https://www.example.com/og.png",
"manifest_url": "https://www.example.com/site.webmanifest",
"theme_color": "#0b5fff",
"author": null,
"publisher": "Example Co",
"published_at": null,
"modified_at": "2026-10-01T08:00:00.000Z",
"feeds": [
{
"url": "https://www.example.com/blog/feed.xml",
"type": "application/rss+xml",
"title": "Example Co blog"
}
],
"oembed_url": null,
"video": null,
"audio": null,
"open_graph": {
"title": "Example Co",
"type": "website",
"url": "https://www.example.com/",
"image": "https://www.example.com/og.png"
},
"twitter_card": {
"card": "summary_large_image",
"title": "Example Co"
},
"structured_data": {
"types": [
"Organization"
],
"items": 1,
"parse_errors": 0
},
"robots": {
"meta": [
"index",
"follow"
],
"header": [],
"indexable": true
},
"security_headers": {
"content-security-policy": "default-src 'self'",
"strict-transport-security": "max-age=63072000; includeSubDomains",
"x-content-type-options": "nosniff",
"x-frame-options": "SAMEORIGIN",
"referrer-policy": "strict-origin-when-cross-origin",
"permissions-policy": null,
"cross-origin-opener-policy": null
},
"links": {
"total": 3,
"internal": 2,
"external": 1
},
"social_profiles": [
{
"platform": "linkedin",
"type": "social",
"handle": "example-co",
"url": "https://www.linkedin.com/company/example-co",
"source": "same_as",
"confidence": "high"
},
{
"platform": "github",
"type": "developer",
"handle": "example-co",
"url": "https://github.com/example-co",
"source": "same_as",
"confidence": "high"
}
],
"contacts": {
"emails": [
"[email protected]"
],
"phones": []
},
"meta": {
"checked_at": "2026-10-09T10:15:30.000Z",
"cached": false,
"fetch_transport": "edge_relay"
}
}
HTTP durum kodları
200OK400Hatalı İstek401Yetkisiz402Ödeme Gerekli429Çok Fazla İstek502Hatalı Ağ Geçidi
POST /v1/url-intelligence/bulk
POST
/v1/url-intelligence/bulk
Kredi: 2/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 |
|---|---|---|
| urls | string[] | gerekli |
Yanıt alanları
| Alan | Tür |
|---|---|
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 |
Örnek istek
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"
]
}'const response = await fetch("https://domscan.net/v1/url-intelligence/bulk", {
method: "POST",
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"urls": [
"https://example.com",
"https://github.com/about"
]
}),
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.post(
"https://domscan.net/v1/url-intelligence/bulk",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
json={
"urls": [
"https://example.com",
"https://github.com/about",
],
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"urls": [
"https://example.com",
"https://github.com/about"
]
}`)
req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/url-intelligence/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")
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/url-intelligence/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({
"urls" => [
"https://example.com",
"https://github.com/about"
]
})
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
{
"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": "https://domscan.net/docs/check-availability",
"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
}
}
HTTP durum kodları
200OK400Hatalı İstek401Yetkisiz402Ödeme Gerekli409HTTP 409422HTTP 422429Çok Fazla İstek