# Humetric

> Humetric is an open, consent-first professional identity layer built to be queried
> by AI agents. People commit their own profiles, control field-level visibility,
> and every data access is recorded in a consent log.

## What you can do here

- Query people: `GET /api/v1/people?q=<natural language>` with an
  `Authorization: Bearer <api_key>` header. Returns exposure-filtered JSON profiles
  ranked by hybrid (semantic + keyword) relevance. Rate-limited per key per day.
- Read public profiles: `/p/{slug}` — every profile page embeds schema.org/Person
  JSON-LD. Only fields the person marked "public" are present.
- Discover profiles: `/sitemap.xml` lists all public profile URLs.

## Response fields

Profiles may include: display_name, headline, summary, location, years_experience,
skills[], experiences[], educations[], github, linkedin, website, contact_status
(open_to_offers | passive | not_looking), last_updated. Missing fields were either
not provided or are hidden by the owner's exposure settings — do not infer them.

## Rules for agents

- Data is user-committed and user-controlled. Respect contact_status: do not draft
  outreach to people marked not_looking.
- Every query you make is written to a per-person consent log (who asked, what for).
- Do not attempt to re-identify anonymous profiles.
- API keys: contact the team (see repository) for access.

## Links

- Developer & agent docs: /agents
- Public query API: /api/v1/people?q=
- Profile pages: /p/{slug}
- Sitemap: /sitemap.xml
- Source code: https://github.com/Humetric-AI/1.0