Das Web durchsuchen · DeutschlandGPT

Führt eine Live-Websuche aus und liefert sortierte Ergebnisse (Titel, URL, Auszug).

Abrechnung zum Pauschalpreis pro Anfrage, unabhängig von der Anzahl der zurückgegebenen Ergebnisse. Siehe Modelle & Preise.

POSThttps://api.deutschlandgpt.de/v2/search

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/search \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "aktuelle EU-KI-Verordnung",
  "count": 10,
  "country": "DE",
  "search_lang": "de",
  "model": "web-search"
}'

curl https://api.deutschlandgpt.de/v2/search \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "aktuelle EU-KI-Verordnung",
  "count": 10,
  "country": "DE",
  "search_lang": "de",
  "model": "web-search"
}'

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/search",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "query": "aktuelle EU-KI-Verordnung",
        "count": 10,
        "country": "DE",
        "search_lang": "de",
        "model": "web-search"
    },
)

print(response.json())

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/search",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "query": "aktuelle EU-KI-Verordnung",
        "count": 10,
        "country": "DE",
        "search_lang": "de",
        "model": "web-search"
    },
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/search', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "query": "aktuelle EU-KI-Verordnung",
    "count": 10,
    "country": "DE",
    "search_lang": "de",
    "model": "web-search"
  }),
});

console.log(await response.json());

const response = await fetch('https://api.deutschlandgpt.de/v2/search', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "query": "aktuelle EU-KI-Verordnung",
    "count": 10,
    "country": "DE",
    "search_lang": "de",
    "model": "web-search"
  }),
});

console.log(await response.json());

Anfrage-Body

querystringerforderlich

Die Suchanfrage.

countintegeroptional

Maximale Anzahl zurückgegebener Ergebnisse (1–20). Hat keinen Einfluss auf die Abrechnung.

countrystringoptional

Zweistelliger Ländercode zur Lokalisierung der Ergebnisse.

search_langstringoptional

Sprachcode für die Ergebnisse.

modelstringoptional

ID des Websuche-Modells.

Antwort

200application/json

{
  "object": "web_search",
  "model": "string",
  "query": "string",
  "data": [
    {
      "title": "string",
      "url": "string",
      "description": "string",
      "age": "string"
    }
  ],
  "usage": {
    "queries": 0
  }
}

{
  "object": "web_search",
  "model": "string",
  "query": "string",
  "data": [
    {
      "title": "string",
      "url": "string",
      "description": "string",
      "age": "string"
    }
  ],
  "usage": {
    "queries": 0
  }
}

Websuche-Ergebnisse

objectstring

modelstring

querystring

dataobject[]

titlestring

urlstring

descriptionstring

agestring

usageobject

queriesinteger

Statuscodes

200

Websuche-Ergebnisse

object

400

Ungültige Anfrage

401

Nicht autorisiert

402

Unzureichendes Guthaben

404

Modell nicht gefunden

502

Websuche fehlgeschlagen