> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hihobbes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find high-intent prospects

> Identify recently active people with high buying intent.

The people endpoint combines activity across sessions. Use it when outreach or
routing should operate on the latest prospect profile rather than one demo.

<CodeGroup>
  ```bash cURL theme={null}
  curl --fail-with-body --get \
    "https://api-us.hihobbes.com/api/v1/people" \
    --data-urlencode "buying_intent=high" \
    --data-urlencode "qualification_status=qualified" \
    --data-urlencode "date_from=2026-07-01T00:00:00Z" \
    --data-urlencode "limit=200" \
    --header "Authorization: Bearer $HOBBES_API_KEY"
  ```

  ```python Python theme={null}
  import os
  import requests

  response = requests.get(
      "https://api-us.hihobbes.com/api/v1/people",
      headers={"Authorization": f"Bearer {os.environ['HOBBES_API_KEY']}"},
      params={
          "buying_intent": "high",
          "qualification_status": "qualified",
          "date_from": "2026-07-01T00:00:00Z",
          "limit": 200,
      },
      timeout=30,
  )
  response.raise_for_status()
  for person in response.json()["people"]:
      print(person["email"], person["totalSessions"], person["summaryMarkdown"])
  ```

  ```typescript TypeScript theme={null}
  const url = new URL("https://api-us.hihobbes.com/api/v1/people");
  url.searchParams.set("buying_intent", "high");
  url.searchParams.set("qualification_status", "qualified");
  url.searchParams.set("date_from", "2026-07-01T00:00:00Z");
  url.searchParams.set("limit", "200");

  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.HOBBES_API_KEY}` },
  });
  if (!response.ok) throw new Error(await response.text());
  const { people } = await response.json();
  console.table(people.map(({ email, totalSessions, summaryMarkdown }) => ({
    email,
    totalSessions,
    summaryMarkdown,
  })));
  ```
</CodeGroup>

Upsert by person `id`. Email is the retrieval key for a single person, but the
stable UUID is the safer external-system identity.