# dweet.io API

> dweet.io API on Apizie: 13 endpoints (Create an alert for a thing. A thing must be locked before an alert can be set., Create a dweet for a thing., Create a dweet for a thing. This method differs from /dweet/for/{thing} only in that successful dweets…, Get the alert attached to a thing., …) returned as clean JSON through one API key. 13 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/iot:dweet/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `iot:dweet`
- Category: IoT
- Status: live
- Source: https://dweet.io
- Page: https://zieapi.vercel.app/api/iot/dweet
- OpenAPI: https://zieapi.vercel.app/api/iot/dweet/openapi.json

Dweet.io allows users to share data from mobile, tablets, and pcs, and them to other devices and accounts across social media platforms. Dweet.io provides an API to access the different functionality of the Dweet.io…

## Endpoints

### Create an alert for a thing. A thing must be locked before an alert can be set.
`GET https://zieapi.vercel.app/v1/iot:dweet/create-alert-get`

| Parameter | Type | Required | Description |
|---|---|---|---|
| who | string | yes | A comma separated list of Email addresses to send the alert to. |
| thing | string | yes | A unique name of a thing. It is recommended that you use a GUID as to avoid name collisions. |
| condition | string | yes | A condition that returns a string or a true value if a condition is met. |
| key | string | yes | A valid key for a locked thing. If the thing is not locked, this can be ignored. |

### Create a dweet for a thing.
`POST https://zieapi.vercel.app/v1/iot:dweet/post-dweet-for-thing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. It is recommended that you use a GUID as to avoid name collisions. |
| key | string | no | A valid key for a locked thing. If the thing is not locked, this can be ignored. |
| body | object | yes | JSON request body |

### Create a dweet for a thing. This method differs from /dweet/for/{thing} only in that successful dweets…
`POST https://zieapi.vercel.app/v1/iot:dweet/post-dweet-quietly-for-thing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. It is recommended that you use a GUID as to avoid name collisions. |
| key | string | no | A valid key for a locked thing. If the thing is not locked, this can be ignored. |
| body | object | yes | JSON request body |

### Get the alert attached to a thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/get-alert`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| key | string | yes | A valid key for a locked thing. If the thing is not locked, this can be ignored. |

### Read the last 5 cached dweets for a thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/get-get-dweets-for-thing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| key | string | no | A valid key for a locked thing. If the thing is not locked, this can be ignored. |

### Read the latest dweet for a thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/get-latest-dweet`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| key | string | no | A valid key for a locked thing. If the thing is not locked, this can be ignored. |

### Read all the saved alerts for a thing from long term storage. You can query a maximum of 1 day per request…
`GET https://zieapi.vercel.app/v1/iot:dweet/get-stored-alerts`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| key | string | yes | A valid key for a locked thing. If the thing is not locked, this can be ignored. |
| date | string | yes | The calendar date (YYYY-MM-DD) from which you'd like to start your query. The response will be a maximum of one day. |
| hour | string | no | The hour of the day represented in the date parameter in 24-hour (00-23) format. If this parameter is included, a maximum of 1 hour will… |
| responseType | string | no | Current valid parameters for this are 'csv' and 'json'. If this parameter is left blank, all responses default to hapi-json dweet-speak. |

### Read all the saved dweets for a thing from long term storage. You can query a maximum of 1 day per request…
`GET https://zieapi.vercel.app/v1/iot:dweet/get-get-stored-dweets-for-thing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| key | string | yes | A valid key for a locked thing. If the thing is not locked, this can be ignored. |
| date | string | yes | The calendar date (YYYY-MM-DD) from which you'd like to start your query. The response will be a maximum of one day. |
| hour | string | no | The hour of the day represented in the date parameter in 24-hour (00-23) format. If this parameter is included, a maximum of 1 hour will… |
| responseType | string | no | Current valid parameters for this are 'csv' and 'json'. If this parameter is left blank, all responses default to hapi-json dweet-speak. |

### Listen for dweets from a thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/listen-for-dweets`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes |  |

### Reserve and lock a thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/lock-thing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| lock | string | yes | A valid dweet.io lock. |
| key | string | yes | A valid dweet.io master key. |

### Remove an alert for a thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/remove-alert`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| key | string | yes | A valid key for a locked thing. If the thing is not locked, this can be ignored. |

### Remove a lock from thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/remove-lock`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lock | string | yes | A valid dweet.io lock. |
| key | string | yes | A valid dweet.io master key. |

### Unlock a thing.
`GET https://zieapi.vercel.app/v1/iot:dweet/unlock-thing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| thing | string | yes | A unique name of a thing. |
| key | string | yes | A valid dweet.io master key. |

## Example
```
curl "https://zieapi.vercel.app/v1/iot:dweet/create-alert-get" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the dweet.io API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/iot:dweet/create-alert-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the dweet.io API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the dweet.io 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 iot:dweet.

### What is the status of the dweet.io API?
Live: works with just an Apizie key