The Watch API

https://thewatchapi.com/documentation
Admin
The Watch API is a REST API providing comprehensive access to watch brand, model, and reference data...
Tokens:9,214
Snippets:57
Trust Score:5
Update:1 month ago
Show doc for...
Tokens:
Raw
### Model List Example Request (HTTP GET)

Source: https://thewatchapi.com/documentation

Example HTTP GET request to the Model List endpoint with the brand and api_token parameters.

```http
GET https://api.thewatchapi.com/v1/model/list?brand=rolex&api_token=YOUR_API_TOKEN
```

--------------------------------

### Reference Search Example Request

Source: https://thewatchapi.com/documentation

Example HTTP GET request for reference search using the 'search' and 'api_token' parameters.

```http
GET https://api.thewatchapi.com/v1/reference/search?search=116520&api_token=YOUR_API_TOKEN
```

--------------------------------

### Brand List Example Request (HTTP GET)

Source: https://thewatchapi.com/documentation

Example HTTP GET request to the Brand List endpoint with the api_token parameter.

```http
GET https://api.thewatchapi.com/v1/brand/list?api_token=YOUR_API_TOKEN
```

--------------------------------

### Reference List Example Request

Source: https://thewatchapi.com/documentation

Example HTTP GET request to list reference numbers for the brand 'rolex' using an API token.

```http
GET https://api.thewatchapi.com/v1/reference/list?brand=rolex&api_token=YOUR_API_TOKEN
```

--------------------------------

### Brand Search Example Request

Source: https://thewatchapi.com/documentation

Example HTTP GET request to search for brands matching 'rolex'.

```http
GET https://api.thewatchapi.com/v1/brand/search?search=rolex&api_token=YOUR_API_TOKEN
```

--------------------------------

### Model Search Example Request

Source: https://thewatchapi.com/documentation

Example HTTP GET request to search for models with 'rolex daytona' in the model attribute, steel case material, and an API token.

```http
GET https://api.thewatchapi.com/v1/model/search?search=rolex daytona&search_attributes=model&case_material=steel&api_token=YOUR_API_TOKEN
```

--------------------------------

### Brand Search Example Response

Source: https://thewatchapi.com/documentation

Example JSON response containing an array of matching brand names.

```json
{
   "data":[
      "Rolex"
   ]
}
```

--------------------------------

### Reference Price History Example Response

Source: https://thewatchapi.com/documentation

Example JSON response from the Reference Price History endpoint, showing metadata and an array of date-price objects.

```json
{
   "meta":{
      "brand":"Rolex",
      "reference_number":"116520"
   },
   "data":[
      {
         "date":"2023-10-13T00:00:00.000Z",
         "price":24653.12
      },
      {
         "date":"2023-10-12T00:00:00.000Z",
         "price":24640.94
      },
      ...
   ]
}
```

--------------------------------

### Model Price History Example Response

Source: https://thewatchapi.com/documentation

Example JSON response from the Model Price History endpoint, showing metadata and an array of date-price objects.

```json
{
   "meta":{
      "brand":"Rolex",
      "model":"Rolex Daytona"
   },
   "data":[
      {
         "date":"2023-10-13T00:00:00.000Z",
         "price":51427.676364
      },
      {
         "date":"2023-10-12T00:00:00.000Z",
         "price":50877.049091
      },
      ...
   ]
}
```

--------------------------------

### Model Price History Example Request

Source: https://thewatchapi.com/documentation

Example HTTP GET request for the Model Price History endpoint, using the model 'rolex daytona' and a placeholder API token.

```http
GET https://api.thewatchapi.com/v1/model/price/history?model=rolex daytona&api_token=YOUR_API_TOKEN
```

--------------------------------

### Brand List Example Response

Source: https://thewatchapi.com/documentation

Example JSON response from the Brand List endpoint, containing an array of brand names under the data key.

```json
{
   "data":[
      "A. Lange & Söhne",
      "Alpina",
      "Andersen Genève",
      "Andreas Strehler",
      "Angelus",
      "Angular Momentum",
      ...
      "Zenith",
      "Zeno-Watch Basel",
      "ZentRa",
      "Zeppelin",
      "Zodiac",
      "ZRC"
   ]
}
```

--------------------------------

### Brand Price History Example Request

Source: https://thewatchapi.com/documentation

Example HTTP GET request for brand price history using the 'brand' and 'api_token' parameters.

```http
GET https://api.thewatchapi.com/v1/brand/price/history?brand=rolex&api_token=YOUR_API_TOKEN
```

--------------------------------

### Reference List Example Response

Source: https://thewatchapi.com/documentation

Example JSON response containing an array of reference numbers.

```json
{
   "data":[
      "226570",
      "14000M",
      "126900",
      "76080",
      "1601",
      "6609",
      "15053",
      "124060",
      "116520",
      "16233",
      ...
   ]
}
```

--------------------------------

### Reference Search Example Response

Source: https://thewatchapi.com/documentation

Example JSON response for the reference search endpoint, showing a matching brand and reference number.

```json
{
   "data":[
      {
         "brand":"Rolex",
         "reference_number":"116520"
      }
   ]
}
```

--------------------------------

### Model List Example Response

Source: https://thewatchapi.com/documentation

Example JSON response from the Model List endpoint, containing an array of model names under the data key.

```json
{
   "data":[
      "Rolex Air King",
      "Rolex Air King Date",
      "Rolex Cellini",
      "Rolex Cellini Danaos",
      "Rolex Cellini Date",
      "Rolex Cellini Dual Time",
      "Rolex Cellini Moonphase",
      "Rolex Cellini Prince",
      "Rolex Cellini Time",
      "Rolex Chronograph",
      "Rolex Datejust",
      "Rolex Datejust 31",
      "Rolex Datejust 36",
      "Rolex Datejust 41",
      "Rolex Datejust II",
      ...
   ]
}
```

--------------------------------

### Reference Price History Example Request

Source: https://thewatchapi.com/documentation

Example HTTP GET request for the Reference Price History endpoint, using reference number 116520 and a placeholder API token.

```http
GET https://api.thewatchapi.com/v1/reference/price/history?reference_number=116520&api_token=YOUR_API_TOKEN
```

--------------------------------

### Model Search Example Response

Source: https://thewatchapi.com/documentation

Example JSON response containing an array of watch data objects with details like brand, reference number, model, movement, and more.

```json
{
   "data":[
      {
         "brand":"Rolex",
         "reference_number":"116520",
         "model":"Rolex Daytona",
         "movement":"Automatic",
         "year_of_production":"1989 - 2018",
         "case_material":"Steel",
         "case_diameter":"40 mm",
         "description":"Introducing the pinnacle of luxury and style - the Rolex Daytona reference number 116520. Meticulously designed and skillfully crafted, this breathtaking timepiece has established itself as the epitome of sophistication and excellence.

         Inspired by the fast-paced world of motorsports, the Daytona line has consistently stood out for its sporty appeal and superior performance. The reference number 116520 takes that legacy to a whole new level with its elegant design and exceptional features.

         Every aspect of this incredible timekeeping tool showcases Rolex's dedication to precision and quality. Each piece is meticulously handcrafted with the finest materials, ensuring that it surpasses the highest standards of watchmaking.

         The case of the Daytona 116520 is made from a solid block of 904L steel which is known for its exceptional corrosion resistance and polishability. Its mirror-like finish and smooth edges make it both stylish and durable. The 40mm size fits comfortably on the wrist and exudes a sense of strength and masculinity."
      }
   ]
}
```

--------------------------------

### Brand Price History Example Response

Source: https://thewatchapi.com/documentation

Example JSON response for the brand price history endpoint, showing meta brand and an array of date-price objects.

```json
{
   "meta":{
      "brand":"Rolex"
   },
   "data":[
      {
         "date":"2023-10-13T00:00:00.000Z",
         "price":20588.861509
      },
      {
         "date":"2023-10-12T00:00:00.000Z",
         "price":19965.662642
      },
      ...
   ]
}
```

--------------------------------

### GET /v1/model/list

Source: https://thewatchapi.com/documentation

Retrieves a list of models for a specified brand. Requires an API token and a brand parameter.

```APIDOC
## GET /v1/model/list

### Description
Retrieves a list of models for a specified brand.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/model/list

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **brand** (string) - Required - Specify the brand to list their models.

### Request Example
GET https://api.thewatchapi.com/v1/model/list?brand=rolex&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **data** (array) - Array list of models.

#### Response Example
{
   "data":[
      "Rolex Air King",
      "Rolex Air King Date",
      "Rolex Cellini",
      "Rolex Cellini Danaos",
      "Rolex Cellini Date",
      "Rolex Cellini Dual Time",
      "Rolex Cellini Moonphase",
      "Rolex Cellini Prince",
      "Rolex Cellini Time",
      "Rolex Chronograph",
      "Rolex Datejust",
      "Rolex Datejust 31",
      "Rolex Datejust 36",
      "Rolex Datejust 41",
      "Rolex Datejust II",
      ...
   ]
}
```

--------------------------------

### Go HTTP Request to Search Models

Source: https://thewatchapi.com/documentation

Uses the net/http package to send a GET request to the model search endpoint. The response body is read and printed.

```go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.thewatchapi.com/v1/model/search?api_token=YOUR_API_TOKEN&search=rolex daytona&search_attributes=model,description&case_material=steel"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

--------------------------------

### GET /v1/reference/list

Source: https://thewatchapi.com/documentation

Retrieves a list of reference numbers for a specified brand. Requires an API token and brand name.

```APIDOC
## GET /v1/reference/list

### Description
Retrieves a list of reference numbers for a specified brand.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/reference/list

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **brand** (string) - Required - Specify the brand to list their reference numbers.

### Request Example
GET https://api.thewatchapi.com/v1/reference/list?brand=rolex&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **data** (array) - Array list of reference numbers.

#### Response Example
{
   "data":[
      "226570",
      "14000M",
      "126900",
      "76080",
      "1601",
      "6609",
      "15053",
      "124060",
      "116520",
      "16233",
      ...
   ]
}
```

--------------------------------

### GET /v1/brand/list

Source: https://thewatchapi.com/documentation

Retrieves a list of all watch brands. Requires an API token for authentication.

```APIDOC
## GET /v1/brand/list

### Description
Retrieves a list of all watch brands.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/brand/list

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.

### Request Example
GET https://api.thewatchapi.com/v1/brand/list?api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **data** (array) - Array list of brands.

#### Response Example
{
   "data":[
      "A. Lange & Söhne",
      "Alpina",
      "Andersen Genève",
      "Andreas Strehler",
      "Angelus",
      "Angular Momentum",
      ...
      "Zenith",
      "Zeno-Watch Basel",
      "ZentRa",
      "Zeppelin",
      "Zodiac",
      "ZRC"
   ]
}
```

--------------------------------

### Example Error Response (JSON)

Source: https://thewatchapi.com/documentation

Shows the JSON structure returned when an API request fails. The error object contains a code and a message describing the issue.

```json
{
    "error": {
        "code": "malformed_parameters",
        "message": "The brand parameter(s) are incorrectly formatted."
    }
}
```

--------------------------------

### Python HTTP Request to Search Models

Source: https://thewatchapi.com/documentation

Uses the http.client module to send a GET request to the model search endpoint. The response is read and printed as a string.

```python
import http.client

conn = http.client.HTTPSConnection("api.thewatchapi.com")
payload = ''
headers = {}
conn.request("GET", "/v1/model/search?api_token=YOUR_API_TOKEN&search=rolex%20daytona&search_attributes=model%2Cdescription&case_material=steel", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

--------------------------------

### Java OkHttp Request to Search Models

Source: https://thewatchapi.com/documentation

Uses OkHttp to send a GET request to the model search endpoint. The response is executed and the result is available in the Response object.

```java
OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://api.thewatchapi.com/v1/model/search?api_token=YOUR_API_TOKEN&search=rolex daytona&search_attributes=model,description&case_material=steel")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();
```

--------------------------------

### C# HttpClient Request to Search Models

Source: https://thewatchapi.com/documentation

Uses HttpClient to send a GET request to the model search endpoint. The response is read as a string and written to the console.

```csharp
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.thewatchapi.com/v1/model/search?api_token=YOUR_API_TOKEN&search=rolex daytona&search_attributes=model,description&case_material=steel");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

--------------------------------

### GET /v1/model/search

Source: https://thewatchapi.com/documentation

Searches for watch models with various filter options. Requires an API token and search criteria.

```APIDOC
## GET /v1/model/search

### Description
Searches for watch models with various filter options.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/model/search

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **search** (string) - Required - Refine data with search criteria. Use the `search_attributes` parameter to specify which attributes to search.
- **search_attributes** (string) - Optional - Specify which attributes to apply the `search` parameter to (comma separated). Available: `brand,model,reference_number,description,case_material,movement`. Default: `model,description`
- **brand** (string) - Optional - Filter the data by brand (exact matches only).
- **model** (string) - Optional - Filter the data by model (exact matches only).
- **reference_number** (string) - Optional - Filter the data by reference_number (exact matches only).
- **movement** (string) - Optional - Filter the data by movement (exact matches only).
- **case_material** (string) - Optional - Filter the data by case material (exact matches only).
- **case_diameter** (string) - Optional - Filter the data by case diameter (exact matches only).

### Request Example
GET https://api.thewatchapi.com/v1/model/search?search=rolex daytona&search_attributes=model&case_material=steel&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **meta > results** (number) - Number of results returned.
- **data > brand** (string) - Brand of the watch.
- **data > reference_number** (string) - reference_number of the watch.
- **data > model** (string) - Model of the watch.
- **data > movement** (string) - Movement of the watch.
- **data > year_of_production** (string) - Years of production range.
- **data > case_material** (string) - Case material of the watch.
- **data > case_diameter** (string) - Case diameter of the watch.
- **data > description** (string) - Description of the watch.
- **data > last_updated** (string) - Last time the record was updated.

#### Response Example
{
   "data":[
      {
         "brand":"Rolex",
         "reference_number":"116520",
         "model":"Rolex Daytona",
         "movement":"Automatic",
         "year_of_production":"1989 - 2018",
         "case_material":"Steel",
         "case_diameter":"40 mm",
         "description":"Introducing the pinnacle of luxury and style - the Rolex Daytona reference number 116520. Meticulously designed and skillfully crafted, this breathtaking timepiece has established itself as the epitome of sophistication and excellence.",
         "last_updated":"2023-01-01"
      }
   ]
}
```

--------------------------------

### GET /v1/reference/search

Source: https://thewatchapi.com/documentation

Searches for watch reference numbers based on search criteria. Returns a list of brands and reference numbers matching the search query.

```APIDOC
## GET /v1/reference/search

### Description
Searches for watch reference numbers based on search criteria. Returns a list of brands and reference numbers matching the search query.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/reference/search

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **search** (string) - Required - Refine reference numbers with search criteria.

### Request Example
GET https://api.thewatchapi.com/v1/reference/search?search=116520&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **meta > results** (number) - Number of results returned.
- **data** (array) - Array list of brands.

#### Response Example
{
   "data": [
      {
         "brand": "Rolex",
         "reference_number": "116520"
      }
   ]
}
```

--------------------------------

### JavaScript fetch Request to Search Models

Source: https://thewatchapi.com/documentation

Uses the fetch API to send a GET request to the model search endpoint. The response is converted to text and logged to the console.

```javascript
var requestOptions = {
  method: 'GET',
  redirect: 'follow'
};

fetch("https://api.thewatchapi.com/v1/model/search?api_token=YOUR_API_TOKEN&search=rolex daytona&search_attributes=model,description&case_material=steel", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
```

--------------------------------

### GET /v1/brand/search

Source: https://thewatchapi.com/documentation

Searches for brands based on a search query. Requires an API token and search criteria.

```APIDOC
## GET /v1/brand/search

### Description
Searches for brands based on a search query.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/brand/search

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **search** (string) - Required - Refine brands with search criteria.

### Request Example
GET https://api.thewatchapi.com/v1/brand/search?search=rolex&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **meta > results** (number) - Number of results returned.
- **data** (array) - Array list of brands.

#### Response Example
{
   "data":[
      "Rolex"
   ]
}
```

--------------------------------

### GET /v1/brand/price/history

Source: https://thewatchapi.com/documentation

Retrieves historical price data for a specified watch brand. Returns daily price points within an optional date range.

```APIDOC
## GET /v1/brand/price/history

### Description
Retrieves historical price data for a specified watch brand. Returns daily price points within an optional date range.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/brand/price/history

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **brand** (string) - Required - Brand to get historical prices for.
- **date_from** (string, format: Y-m-d) - Optional - Refine data by retrieving data after and including the specified date. Default is the max allowed on your plan.
- **date_to** (string, format: Y-m-d) - Optional - Refine data by retrieving data before and including the specified date. Default is the max allowed on your plan.

### Request Example
GET https://api.thewatchapi.com/v1/brand/price/history?brand=rolex&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **meta > brand** (string) - Watch brand.
- **data > date** (string) - Date of the relative price.
- **data > price** (number) - Price on that day in USD.

#### Response Example
{
   "meta": {
      "brand": "Rolex"
   },
   "data": [
      {
         "date": "2023-10-13T00:00:00.000Z",
         "price": 20588.861509
      },
      {
         "date": "2023-10-12T00:00:00.000Z",
         "price": 19965.662642
      }
   ]
}
```

--------------------------------

### PHP cURL Request to Search Models

Source: https://thewatchapi.com/documentation

Uses cURL to send a GET request to the model search endpoint with query parameters for search, search_attributes, and case_material. Replace YOUR_API_TOKEN with your actual token.

```php
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.thewatchapi.com/v1/model/search?api_token=YOUR_API_TOKEN&search=rolex daytona&search_attributes=model,description&case_material=steel',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

--------------------------------

### GET /v1/reference/price/history

Source: https://thewatchapi.com/documentation

Retrieves historical price data for a specific watch reference number. Requires an API token and reference number, with optional date range parameters to refine the results.

```APIDOC
## GET /v1/reference/price/history

### Description
Retrieves historical price data for a specific watch reference number. Requires an API token and reference number, with optional date range parameters to refine the results.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/reference/price/history

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **reference_number** (string) - Required - Reference number to get historical prices for.
- **date_from** (string, format: Y-m-d) - Optional - Refine data by retrieving data after and including the specified date. Default is the max allowed on your plan.
- **date_to** (string, format: Y-m-d) - Optional - Refine data by retrieving data before and including the specified date. Default is the max allowed on your plan.

### Request Example
GET https://api.thewatchapi.com/v1/reference/price/history?reference_number=116520&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **meta > brand** (string) - Watch brand.
- **meta > model** (string) - Watch model.
- **data > date** (string) - Date of the relative price.
- **data > price** (number) - Price on that day in USD.

#### Response Example
{
   "meta":{
      "brand":"Rolex",
      "reference_number":"116520"
   },
   "data":[
      {
         "date":"2023-10-13T00:00:00.000Z",
         "price":24653.12
      },
      {
         "date":"2023-10-12T00:00:00.000Z",
         "price":24640.94
      }
   ]
}
```

--------------------------------

### GET /v1/model/price/history

Source: https://thewatchapi.com/documentation

Retrieves historical price data for a specific watch model. Requires an API token and model name, with optional date range parameters to refine the results.

```APIDOC
## GET /v1/model/price/history

### Description
Retrieves historical price data for a specific watch model. Requires an API token and model name, with optional date range parameters to refine the results.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/model/price/history

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **model** (string) - Required - Model to get historical prices for.
- **date_from** (string, format: Y-m-d) - Optional - Refine data by retrieving data after and including the specified date. Default is the max allowed on your plan.
- **date_to** (string, format: Y-m-d) - Optional - Refine data by retrieving data before and including the specified date. Default is the max allowed on your plan.

### Request Example
GET https://api.thewatchapi.com/v1/model/price/history?model=rolex daytona&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **meta > brand** (string) - Watch brand.
- **meta > model** (string) - Watch model.
- **data > date** (string) - Date of the relative price.
- **data > price** (number) - Price on that day in USD.

#### Response Example
{
   "meta":{
      "brand":"Rolex",
      "model":"Rolex Daytona"
   },
   "data":[
      {
         "date":"2023-10-13T00:00:00.000Z",
         "price":51427.676364
      },
      {
         "date":"2023-10-12T00:00:00.000Z",
         "price":50877.049091
      }
   ]
}
```

--------------------------------

### GET /v1/model/search

Source: https://thewatchapi.com/documentation

Searches for watch models based on provided search criteria. The endpoint accepts query parameters for search terms, attributes to search, and filters like case material. The response is a JSON object containing matching models.

```APIDOC
## GET /v1/model/search

### Description
Searches for watch models based on provided search criteria. The endpoint accepts query parameters for search terms, attributes to search, and filters like case material. The response is a JSON object containing matching models.

### Method
GET

### Endpoint
https://api.thewatchapi.com/v1/model/search

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token for authentication.
- **search** (string) - Required - The search query string (e.g., "rolex daytona").
- **search_attributes** (string) - Optional - Comma-separated list of attributes to search (e.g., "model,description").
- **case_material** (string) - Optional - Filter by case material (e.g., "steel").

### Request Example
GET https://api.thewatchapi.com/v1/model/search?api_token=YOUR_API_TOKEN&search=rolex%20daytona&search_attributes=model%2Cdescription&case_material=steel

### Response
#### Success Response (200)
- **error** (object) - An object containing error details (if any).
- **error.code** (string) - The error code.
- **error.message** (string) - A human-readable error message.

#### Response Example
{
    "error": {
        "code": "malformed_parameters",
        "message": "The brand parameter(s) are incorrectly formatted."
    }
}

### Errors
- **malformed_parameters** (400) - Validation of parameters failed. The failed parameters are usually shown in the error message.
- **too_many_results** (400) - The number of results exceeds your plan allowance. The number of results is usually shown in the error message. You must refine your search criteria further.
- **invalid_api_token** (401) - Invalid API token.
- **usage_limit_reached** (402) - Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the `X-UsageLimit-Limit` header.
- **endpoint_access_restricted** (403) - Access to the endpoint is not available on your current subscription plan.
- **resource_not_found** (404) - Resource could not be found.
- **invalid_api_endpoint** (404) - API route does not exist.
- **rate_limit_reached** (429) - Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the `X-RateLimit-Limit` header.
- **server_error** (500) - A server error occured.
- **maintenance_mode** (503) - The service is currently under maintenance.
```

--------------------------------

### Brand List Endpoint

Source: https://thewatchapi.com/documentation

The endpoint URL for listing all brands. Requires the api_token parameter.

```http
GET https://api.thewatchapi.com/v1/brand/list HTTP/1.1
```

--------------------------------

### Model List Endpoint

Source: https://thewatchapi.com/documentation

The endpoint URL for listing models of a specific brand. Requires the api_token and brand parameters.

```http
GET https://api.thewatchapi.com/v1/model/list HTTP/1.1
```

--------------------------------

### Reference List Endpoint

Source: https://thewatchapi.com/documentation

Endpoint for listing reference numbers for a specified brand. Requires api_token and brand parameters.

```http
GET https://api.thewatchapi.com/v1/reference/list HTTP/1.1
```

--------------------------------

### Brand Search Endpoint

Source: https://thewatchapi.com/documentation

Endpoint for searching brands. Requires api_token and search parameters.

```http
GET https://api.thewatchapi.com/v1/brand/search HTTP/1.1
```

--------------------------------

### Model Price History Endpoint

Source: https://thewatchapi.com/documentation

The endpoint URL for retrieving historical prices for a watch model. Requires an API token and model name.

```http
GET https://api.thewatchapi.com/v1/model/price/history HTTP/1.1
```

--------------------------------

### Reference Price History Endpoint

Source: https://thewatchapi.com/documentation

The endpoint URL for retrieving historical prices for a reference number. Requires an API token and reference number.

```http
GET https://api.thewatchapi.com/v1/reference/price/history HTTP/1.1
```

--------------------------------

### Model Search Endpoint

Source: https://thewatchapi.com/documentation

Endpoint for searching models. Requires api_token and search parameters. Supports optional filters and search_attributes.

```http
GET https://api.thewatchapi.com/v1/model/search HTTP/1.1
```

--------------------------------

### Reference Search Endpoint

Source: https://thewatchapi.com/documentation

Endpoint for searching reference numbers. Available on all plans.

```http
GET https://api.thewatchapi.com/v1/reference/search HTTP/1.1
```

--------------------------------

### Brand Price History Endpoint

Source: https://thewatchapi.com/documentation

Endpoint for retrieving historical prices for a brand. High usage, available on Standard plan and above.

```http
GET https://api.thewatchapi.com/v1/brand/price/history HTTP/1.1
```
Tokens:
Raw