# HomeGraph API API

> HomeGraph API API on Apizie: 5 endpoints (Unlinks the given third-party user from your smart home Action. All data related to this user will be…, Gets the current states in Home Graph for the given set of the third-party user's devices. The third-party…, Reports device state and optionally sends device notifications. Called by your smart home Action when the…, Requests Google to send an `action.devices.SYNC`…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-homegraph`
- Category: Analytics
- Status: byok
- Source: https://developers.home.google.com/cloud-to-cloud/get-started
- Page: https://zieapi.vercel.app/api/analytics/googleapis-homegraph
- OpenAPI: https://zieapi.vercel.app/api/analytics/googleapis-homegraph/openapi.json



## Endpoints

### Unlinks the given third-party user from your smart home Action. All data related to this user will be…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/homegraph-agent-users-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agentUserId | string | yes | Required. Third-party user ID. |
| requestId | string | no | Request ID used for debugging. |

### Gets the current states in Home Graph for the given set of the third-party user's devices. The third-party…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/homegraph-devices-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Reports device state and optionally sends device notifications. Called by your smart home Action when the…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/homegraph-devices-report-state-and-notification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Requests Google to send an `action.devices.SYNC`…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/homegraph-devices-request-sync` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Gets all the devices associated with the given third-party user. The third-party user's identity is passed…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/homegraph-devices-sync` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/homegraph-agent-users-delete" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the HomeGraph API API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/analytics:googleapis-homegraph/homegraph-agent-users-delete with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the HomeGraph API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. HomeGraph API itself also needs your own key from googleapis.com.

### Can AI agents use the HomeGraph API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-homegraph.

### What is the status of the HomeGraph API API?
Needs your own provider key (bring your own key)