# Spending Pulse API

> Spending Pulse API on Apizie: 4 endpoints (Returns the weekly gasoline report. This resource pulls back the report with ProductLine = "US Weekly…, Returns a distinct list of all reports are available and that one is subscribed to., Returns all Spending Pulse reports (with the exception of the gasoline weekly report, which has its own…, Returns a list of all reports one is currently subscribed to.) returned as clean JSON through one API key. 4 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:mastercard-spending-pulse/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:mastercard-spending-pulse`
- Category: Open Data
- Status: live
- Source: https://mastercard.com
- Page: https://zieapi.vercel.app/api/open-data/mastercard-spending-pulse
- OpenAPI: https://zieapi.vercel.app/api/open-data/mastercard-spending-pulse/openapi.json

This API will provide monthly data which includes metrics such as sales volume and growth rate.

## Endpoints

### Returns the weekly gasoline report. This resource pulls back the report with ProductLine = "US Weekly…
`GET https://zieapi.vercel.app/v1/open-data:mastercard-spending-pulse/get-gasweekly`

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentRow | string | no | Starting record number to return. |
| Offset | string | no | Used to restrict the number of records returned if needed to be less than max. |

### Returns a distinct list of all reports are available and that one is subscribed to.
`GET https://zieapi.vercel.app/v1/open-data:mastercard-spending-pulse/get-parameters`

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentRow | string | no | Starting record number to return. |
| Offset | string | no | Used to restrict the number of records returned if needed to be less than max. |

### Returns all Spending Pulse reports (with the exception of the gasoline weekly report, which has its own…
`GET https://zieapi.vercel.app/v1/open-data:mastercard-spending-pulse/get-spendingpulse`

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentRow | string | no | Starting record number to return. |
| Offset | string | no | Used to restrict the number of records returned if needed to be less than max. |
| ProductLine | string | no | Product Line. Either ?US Executive Report? or ?Weekly Sales? |
| PublicationCoveragePeriod | string | no | Publication Coverage Period indicates what period is to be covered, often the current report will include the month prior. |
| Country | string | no | Country code. |
| ReportType | string | no | Report type name, today the only report supported is "monitor". |
| Period | string | no | Indicates the period covered by the data with possible values of - day, week, month, quarter, annual |
| Sector | string | no | Sector name. |
| Ecomm | string | no | Ecommerce indicator. |

### Returns a list of all reports one is currently subscribed to.
`GET https://zieapi.vercel.app/v1/open-data:mastercard-spending-pulse/get-subscription`

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentRow | string | no | Starting record number to return. |
| Offset | string | no | Used to restrict the number of records returned if needed to be less than max. |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:mastercard-spending-pulse/get-gasweekly" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Spending Pulse API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:mastercard-spending-pulse/get-gasweekly with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Spending Pulse 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 Spending Pulse 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 open-data:mastercard-spending-pulse.

### What is the status of the Spending Pulse API?
Live: works with just an Apizie key