# Dealer API

> Dealer API on Apizie: 3 endpoints (This request returns the countries supported by the Dealer API, This request returns dealers (dealer, garage, retailer, etc.) for given parameters, This request returns dealers for given parameters) returned as clean JSON through one API key. 3 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/transport:mercedes-benz-dealer/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `transport:mercedes-benz-dealer`
- Category: Transport
- Status: live
- Source: https://mercedes-benz.com
- Page: https://zieapi.vercel.app/api/transport/mercedes-benz-dealer
- OpenAPI: https://zieapi.vercel.app/api/transport/mercedes-benz-dealer/openapi.json

The Dealer API provides Dealer search functions.

## Endpoints

### This request returns the countries supported by the Dealer API
`GET https://zieapi.vercel.app/v1/transport:mercedes-benz-dealer/countries-get`

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | The index of the page to be returned. If this parameter is omitted, the first page will be returned. |
| pageSize | integer | no | The index of the page to be returned. If this parameter is omitted, the first page will be returned. |

### This request returns dealers (dealer, garage, retailer, etc.) for given parameters
`GET https://zieapi.vercel.app/v1/transport:mercedes-benz-dealer/dealers-get`

| Parameter | Type | Required | Description |
|---|---|---|---|
| dealerIds | array | no | Array of dealer ids. The dealer id is dealer’s business key, also known as GS Id. e.g. GS0000857,GS0017621 |
| latitude | number | no | The latitude geo coordinate. |
| longitude | number | no | The longitude geo coordinate. |
| radiusValue | integer | no | The radius value of the search area. The center of the search area is defined by geo coordinates. (latitude, longitude properties) If… |
| radiusUnit | string | no | The radius unit of the search area. The center of the search area is defined by geo coordinates. (latitude, longitude properties) If… |
| countryIsoCode | string | no | The country of the dealer address defined as ISO two letter ID (e.g. DE, CH, CN, etc.) |
| city | string | no | The city of the dealer address. |
| name | string | no | A name of the dealer, the name filter will be applied to all Dealer names (e.g. legalName, nameAddition). You can also search for parts of… |
| brand | string | no | Filter by brand, valid values are: * MB: Mercedes-Benz * SMT: Smart |
| productGroup | string | no | Filter by a product group |
| activity | string | no | Filter by activity, valid actitvity values are: * PARTS: Spare Parts Sales * SALES: Sales of new vehicles * SERVICE: Maintaining and… |
| fields | string | no | Specifies which fields should be included in the result. If this filter is not used, per default all fields are returned. e.g.… |
| page | integer | no | The index of the page to be returned. If this parameter is omitted, the first page will be returned. |
| pageSize | integer | no | The index of the page to be returned. If this parameter is omitted, the first page will be returned. |

### This request returns dealers for given parameters
`GET https://zieapi.vercel.app/v1/transport:mercedes-benz-dealer/dealer-get`

| Parameter | Type | Required | Description |
|---|---|---|---|
| dealerId | string | yes | The dealer id is dealer’s business key, also known as GS Id. e.g. GS0000857 |
| fields | string | no | Specifies which fields should be included in the result. If this filter is not used, per default all fields are returned. e.g.… |

## Example
```
curl "https://zieapi.vercel.app/v1/transport:mercedes-benz-dealer/countries-get" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Dealer API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/transport:mercedes-benz-dealer/countries-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Dealer 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 Dealer 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 transport:mercedes-benz-dealer.

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