# Ehorses Search

## Overview

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

## Description

Access Ehorses horse listings with our API for unparalleled market insights and strategic advantages.

## 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/ehorses/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "results": [
    {
      "age": "5 years",
      "color": "Bay",
      "image": "https://www.ehorses.com/images/horse1.jpg",
      "price": "15,000 USD",
      "title": "Stunning Arabian Stallion",
      "height": "15.2 hands",
      "location": "Houston, TX",
      "description": "Beautiful Arabian stallion, well-trained and with a gentle temperament. Ready for both show and pleasure riding."
    },
    {
      "age": "4 years",
      "color": "Chestnut",
      "image": "https://www.ehorses.com/images/horse2.jpg",
      "price": "20,000 USD",
      "title": "Elegant Thoroughbred Mare",
      "height": "16 hands",
      "location": "Lexington, KY",
      "description": "Elegant Thoroughbred mare with a strong pedigree. Perfect for racing enthusiasts."
    },
    {
      "age": "8 years",
      "color": "Dun",
      "image": "https://www.ehorses.com/images/horse3.jpg",
      "price": "10,500 USD",
      "title": "Gentle Fjord Gelding",
      "height": "14 hands",
      "location": "Denver, CO",
      "description": "Friendly and gentle Fjord gelding, ideal for family and kids. Loves trail riding."
    }
  ],
  "pagination": {
    "totalPages": 50,
    "currentPage": 1,
    "totalResults": 1500
  }
}
```

## Documentation

## Overview
Access Ehorses horse listings with our API for unparalleled market insights and strategic advantages.

## Quickstart
```
GET https://api.piloterr.com/v2/ehorses/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Ehorses Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Ehorses without maintaining scrapers
- Power internal dashboards and workflow automations with live Ehorses data