> 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/de/docs/products/url-intelligence

# API für Einheitliche URL-Intelligence

Extrahieren Sie normalisierte Seitenmetadaten, Vorschaufelder, strukturierte Daten und öffentliche Identitätssignale aus einer URL. Nutzen Sie diese Referenz, um den passenden Endpunkt zu wählen und genau zu sehen, was er zurückgibt.

[Produktseite ansehen](https://domscan.net/de/url-metadata-api)

## Operationen

GET `/v1/url-intelligence` [API-Referenz ansehen](https://domscan.net/de/docs/products/url-intelligence#getUrlIntelligence)

POST `/v1/url-intelligence/bulk` [API-Referenz ansehen](https://domscan.net/de/docs/products/url-intelligence#bulkGetUrlIntelligence)

## GET `/v1/url-intelligence`

Operation: `getUrlIntelligence`
Credits und Authentifizierung: 2
Authentifizierung erforderlich

GET /v1/url-intelligence Credits: 2

#### Abfrageparameter

| Parameter | Typ | erforderlich |
| --- | --- | --- |
| url | string | erforderlich |
| skip_cache | string Zulässige Werte `1` | optional |

#### Antwortfelder

| Feld | Typ |
| --- | --- |
| `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 |

#### Beispielanfrage

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

```javascript
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);
```

```python
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())
```

```go
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"))

```ruby
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")

#### Beispielantwort

```json
{
  "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": [
      "hello@example.com"
    ],
    "phones": []
  },
  "meta": {
    "checked_at": "2026-10-09T10:15:30.000Z",
    "cached": false,
    "fetch_transport": "edge_relay"
  }
}
```

#### HTTP-Statuscodes

- `200` OK
- `400` Ungültige Anfrage
- `401` Nicht autorisiert
- `402` Zahlung erforderlich
- `429` Zu viele Anfragen
- `502` Fehlerhaftes Gateway

## POST `/v1/url-intelligence/bulk`

Operation: `bulkGetUrlIntelligence`
Credits und Authentifizierung: 2
Authentifizierung erforderlich

POST /v1/url-intelligence/bulk Credits: 2/item

#### Abfrageparameter

| Parameter | Typ | erforderlich |
| --- | --- | --- |
| dry_run | string Zulässige Werte `true` | optional |

#### Body-Parameter

| Parameter | Typ | erforderlich |
| --- | --- | --- |
| urls | string[] | erforderlich |

#### Antwortfelder

| Feld | Typ |
| --- | --- |
| `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 |

#### Beispielanfrage

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

```javascript
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);
```

```python
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())
```

```go
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))
}
```

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

#### Beispielantwort

```json
{
  "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-Statuscodes

- `200` OK
- `400` Ungültige Anfrage
- `401` Nicht autorisiert
- `402` Zahlung erforderlich
- `409` HTTP 409
- `422` HTTP 422
- `429` Zu viele Anfragen

## Referenzressourcen

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