# Wildcard API - [Introduction](https://docs.trywildcard.ai/introduction.md): Programmatic access to your Wildcard data - [Authentication](https://docs.trywildcard.ai/authentication.md): How to authenticate with the Wildcard API - [Rate Limits](https://docs.trywildcard.ai/rate-limits.md): Understanding API rate limits and how to handle them - [Errors](https://docs.trywildcard.ai/errors.md): API error codes and how to handle them - [Partners](https://docs.trywildcard.ai/partners.md): Provision sites, organize customer groups, and read their visitors through the API - [AI Connectors](https://docs.trywildcard.ai/claude-connector.md): Access Wildcard data from Claude, Claude Code, ChatGPT, or Codex - [Attio](https://docs.trywildcard.ai/attio.md): Sync identified visitors and companies to your Attio workspace - [Microsoft Teams](https://docs.trywildcard.ai/microsoft-teams.md): Get identified people and companies delivered to your Teams channels in real time - [Python](https://docs.trywildcard.ai/examples/python.md): Python examples for the Wildcard API - [JavaScript](https://docs.trywildcard.ai/examples/javascript.md): JavaScript/Node.js examples for the Wildcard API - [cURL](https://docs.trywildcard.ai/examples/curl.md): cURL examples for the Wildcard API - [Health Check](https://docs.trywildcard.ai/api-reference/health.md): Check if the API is operational. No authentication required. - [List People](https://docs.trywildcard.ai/api-reference/list-people.md): Returns a paginated list of identified website visitors - [Get Person](https://docs.trywildcard.ai/api-reference/get-person.md): Returns details for a single identified person - [List Person Events](https://docs.trywildcard.ai/api-reference/list-person-events.md): Returns the full journey — every tracked event for a specific person - [List Companies](https://docs.trywildcard.ai/api-reference/list-companies.md): Returns a paginated list of identified companies - [Get Company](https://docs.trywildcard.ai/api-reference/get-company.md): Returns details for a single identified company - [Get Page Traffic](https://docs.trywildcard.ai/api-reference/traffic-pages.md): Page loads per page for people and AI agents, including anonymous visitors - [Send Server Page Events](https://docs.trywildcard.ai/api-reference/traffic-events.md): Report page requests your server saw, so AI crawlers that don't run JavaScript are counted - [Get Statistics](https://docs.trywildcard.ai/api-reference/stats.md): Returns aggregate dashboard analytics - [List Partner Domains](https://docs.trywildcard.ai/api-reference/list-partner-domains.md): Lists tracked sites, current synchronization state, the shared pixel snippet, and maxDomains (the configured account limit). Uses the partner management key. - [Register a Partner Domain](https://docs.trywildcard.ai/api-reference/register-partner-domain.md): Registers a site under the authenticated partner account and returns its installation snippet. Optional groupId attaches the new or existing owned site to that group. A group must exist first. Never creates a separate customer account or overrides paused tracking. Retry 429 with backoff. - [Update a Partner Domain](https://docs.trywildcard.ai/api-reference/update-partner-domain.md): Changes one tracked site in your partner account. Send the `domain` and one `action`: - [Remove a Partner Domain](https://docs.trywildcard.ai/api-reference/remove-partner-domain.md): Stops tracking a site and removes it from the pixel within a few minutes. Revoke any client data key for the site separately with `DELETE /v1/partner/api-keys`. Uses the partner management key. - [List Domain Groups](https://docs.trywildcard.ai/api-reference/list-domain-groups.md): Lists this partner account's groups with current owned membership. Uses the partner management key, not a visitor-data key. - [Create a Domain Group](https://docs.trywildcard.ai/api-reference/create-domain-group.md): Creates a named group. A stable groupId with the same name is idempotent when domains is omitted, preserving later attachments. An explicitly different name or domains payload returns 409. Domains must already belong to this partner. - [Update a Domain Group](https://docs.trywildcard.ai/api-reference/update-domain-group.md): Updates name and/or replaces the full domain membership. An empty domains array empties the group. This never activates tracking. - [Delete a Domain Group](https://docs.trywildcard.ai/api-reference/delete-domain-group.md): Removes the group only. Sites, tracking status, and visitor history remain intact. Deleting an absent group is idempotent. - [Create a Client Data Key](https://docs.trywildcard.ai/api-reference/create-client-data-key.md): Creates an mk_live data key scoped to one existing tracked domain. The raw key is returned once. Calling again rotates and revokes the previous key; this is not an idempotent creation call. The caller authenticates with its pk_live management key. - [List Client Data Keys](https://docs.trywildcard.ai/api-reference/list-client-data-keys.md): Lists the sites in your partner account that have a client data key, with each key's prefix and when it was created and last used. Never returns the key itself. Uses the partner management key. - [Revoke a Client Data Key](https://docs.trywildcard.ai/api-reference/revoke-client-data-key.md): Revokes the client data key for one site. Calls with that key fail straight away. The site keeps being tracked. Uses the partner management key. ## OpenAPI Specs - [openapi](/openapi.yaml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.