Knowledge Graph API: Query Structured Entity Data

async function lookupEntity(query, type = null) {
  const params = new URLSearchParams({
    key: process.env.KG_API_KEY,
    query,
    limit: "3",
    indent: "false",
  });
  if (type) params.set("types", type);

  const url = `https://kgsearch.googleapis.com/v1/entities:search?${params}`;
  const response = await fetch(url);

  if (!response.ok) {
    throw new Error(`Knowledge Graph API error: ${response.status}`);
  }

  const data = await response.json();
  return data.itemListElement ?? [];
}

// Usage
const results = await lookupEntity("Python programming language", "SoftwareApplication");
results.forEach(({ result, resultScore }) => {
  console.log(`${result.name} (score: ${resultScore})`);
  console.log(result.description ?? "No description");
  console.log(result.detailedDescription?.articleBody ?? "");
});

import os
import urllib.parse
import urllib.request
import json

def lookup_entity(query, entity_type=None, limit=3):
    params = {
        "key": os.environ["KG_API_KEY"],
        "query": query,
        "limit": str(limit),
    }
    if entity_type:
        params["types"] = entity_type

    url = "https://kgsearch.googleapis.com/v1/entities:search?" + urllib.parse.urlencode(params)

    with urllib.request.urlopen(url) as response:
        data = json.loads(response.read())

    return data.get("itemListElement", [])

# Usage
results = lookup_entity("Python programming language", entity_type="SoftwareApplication")
for entry in results:
    result = entry["result"]
    print(result["name"], f"(score: {entry['resultScore']})")
    print(result.get("description", "No description"))
    print(result.get("detailedDescription", {}).get("articleBody", ""))