# Mascus Ad

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/mascus/ad` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/mascus-ad |

## Description

Get full details for a Mascus used equipment listing: specs, price, seller and description.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/mascus/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Doppstadt AK 435 Profi listing

```json
{
  "brand": "Doppstadt",
  "model": "AK 435 Profi",
  "meta_data": {
    "meta_title": "Doppstadt AK 435 Profi, 2012, France - Mascus France"
  },
  "catalog_name": "construction",
  "company_city": "saint-genis-laval",
  "company_name": "RHONE ENVIRONNEMENT",
  "user_currency": "EUR",
  "company_country": "FR",
  "asset_details_info": [
    {
      "label": "Année",
      "value": "2012"
    }
  ],
  "asset_pricing_info": [
    {
      "label": "Prix",
      "value": "108 000 EUR"
    }
  ],
  "price_in_user_currency": 108000
}
```

## Documentation

## Overview
The Mascus Ad endpoint returns full details for one used equipment listing: brand, model, price, seller, location, specs and description.

Pass a listing URL, usually from `results[].url` in [Mascus Search](https://www.piloterr.com/library/mascus-search). The country site is detected from the URL.

## Quickstart
```
GET https://api.piloterr.com/v2/mascus/ad?query=https://www.mascus.fr/travaux-publics/broyeur-dechets/doppstadt-ak-435-profi/hocmgmfi.html
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Mascus listing URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `brand` / `model` | string | Machine |
| `price_in_user_currency` / `user_currency` | number / string | Price |
| `company_name` / `company_city` / `company_country` | string | Seller |
| `catalog_name` / `category_path` | string | Category |
| `asset_basic_info` / `asset_details_info` / `asset_pricing_info` | array | Specs and pricing labels |
| `meta_data` | object | Title and description metadata |

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing `query` or invalid domain |
| `404` | Listing not found |
| `500` | Temporary failure |

## Notes
- Works on all Mascus country sites

## Related endpoints
- [Mascus Search](https://www.piloterr.com/library/mascus-search): discover listing URLs by category

## Main use cases
- Enrich a search result with full specs and seller details
- Track a listing price over time
- Feed asset valuation or procurement tools