# Jirafe Events API

> Jirafe Events API on Apizie: 6 endpoints (Send a batch for the given site, Send a cart for the given site, Send a category for the given site, Send a customer for the given site, …) 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/business:jirafe/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `business:jirafe`
- Category: Business
- Status: byok
- Source: https://jirafe.com
- Page: https://zieapi.vercel.app/api/business/jirafe
- OpenAPI: https://zieapi.vercel.app/api/business/jirafe/openapi.json

API endpoins for sending Jirafe events

## Endpoints

### Send a batch for the given site
`POST https://zieapi.vercel.app/v1/business:jirafe/post-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| siteId | string | yes | ID site to send the event |
| body | object | yes | JSON request body |

### Send a cart for the given site
`POST https://zieapi.vercel.app/v1/business:jirafe/post-cart` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| siteId | string | yes | ID site to send the event |
| body | object | yes | JSON request body |

### Send a category for the given site
`POST https://zieapi.vercel.app/v1/business:jirafe/post-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| siteId | string | yes | ID site to send the event |
| body | object | yes | JSON request body |

### Send a customer for the given site
`POST https://zieapi.vercel.app/v1/business:jirafe/post-customer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| siteId | string | yes | ID site to send the event |
| body | object | yes | JSON request body |

### Send a order for the given site
`POST https://zieapi.vercel.app/v1/business:jirafe/post-order-cancelled` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| siteId | string | yes | ID site to send the event |
| body | object | yes | JSON request body |

### Send a product for the given site
`POST https://zieapi.vercel.app/v1/business:jirafe/post-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| siteId | string | yes | ID site to send the event |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/business:jirafe/post-batch" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Jirafe Events API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/business:jirafe/post-batch with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Jirafe Events 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 business:jirafe.

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