Documentation Agent HTTPSearch celebrities tool

Search celebrities tool

POST/agent/v1/tools/search-celebritiesAgent HTTPFrom Business

Search public figures through an agent-safe interface.

Let assistants find well-known Human Design examples through a free, non-consuming lookup with a stable tool envelope and bounded results.

Authentication

Use Authorization: Bearer YOUR_API_KEY or X-Api-Key. Query-key authentication is deprecated compatibility behavior on supported REST routes and is rejected on Agent HTTP and MCP surfaces. Never put credentials in URLs, request bodies, or browser code.

Parameters

Name	In	Required	Description
`Authorization`	header	Yes	Bearer API key. X-Api-Key is also supported. `Bearer YOUR_API_KEY`
`query`	body	Yes	Celebrity name query. `Beyoncé`
`limit`	body	No	Result limit from 1 to 100. `10`

Quota effect

This is a free, non-consuming lookup. Authorized calls use 0 calculation units.

Errors

Expect 400 for invalid input, 401 for a missing or malformed key, 403 when the active plan does not include this operation, and 429 when the monthly allowance is exhausted.

Related operations

RequestcURL

curl -X POST "https://api.humandesign.ai/agent/v1/tools/search-celebrities" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "Beyoncé",
  "limit": 10
}'

Verified response examplecURL

{
  "version": "v1",
  "tool": "search_celebrities",
  "data": {
    "results": [
      {
        "id": 45805,
        "name": "Beyoncé",
        "slug": "beyonce",
        "imageUrl": "https://cidxhzeymibouhqghbrt.supabase.co/storage/v1/object/public/celebrity-content-assets/celebrity-source-images/95cbd3af-7f71-4c2e-95e5-fca602bd6996/beyonce.jpg",
        "hdType": "Generator",
        "hdProfile": "2/4",
        "professions": null
      }
    ],
    "total": 1,
    "query": "Beyoncé"
  },
  "meta": {
    "surface": "agent_http",
    "operation": "search_celebrities",
    "requiredTier": "business",
    "tool": {
      "query": "Beyoncé",
      "limit": 10,
      "total": 1
    }
  },
  "error": null
}

Captured from the live API on 6 August 2026. 43/43 live checks passed. Secrets and account-specific usage are removed; large payloads show a truthful excerpt.

Free includes 100 calls every month.
Free members can use every operation labelled “From Free,” including the core Agent HTTP and MCP tools.