# Trip.com Coach Search API Documentation

<p><strong>Trip.com Coach Search API Documentation</strong> Search coach journeys for one day. Each coach has an id, local departure and arrival times in ISO 8601, duration, changes, both stations and the cheapest fare when Trip.com shows one. Codes are coach station codes such as GBLONGGE or city codes such as GB1594 (London) and GB1677 (Manchester) from the Train Stations endpoint in coach mode. A pair or date without coaches returns an empty list and costs nothing. has_more is true when Trip.com has more coaches on a next page; only the first page is returned. One way only. Cost: 1 credit per successful call. Failed calls cost 0.</p>

- **Documentation:** [https://scrappa.co/docs/tripcom-api/tripcom_buses_search](https://scrappa.co/docs/tripcom-api/tripcom_buses_search)
- **API group:** Trip.com API
- **Endpoint:** `GET https://scrappa.co/api/tripcom/buses/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `from` | string | Yes | Departure coach station or city code, e.g. GB1594 (London). |
| `to` | string | Yes | Arrival coach station or city code, e.g. GB1677 (Manchester). |
| `date` | string | Yes | Departure date, YYYY-MM-DD, today or later. |
| `currency` | string | No | USD, EUR, GBP, JPY or KRW. Defaults to USD. Prices come back in this currency. |
| `locale` | string | No | Site language: en, en-gb, de, fr, ja, ko or zh-hk. Defaults to en. |

## Example response

```json
{
    "data": {
        "to": "GB1677",
        "date": "2027-03-14",
        "from": "GB1594",
        "total": 1,
        "coaches": [
            {
                "id": "s2@BUS...",
                "tags": [
                    "allowed_e_ticket",
                    "cheapest"
                ],
                "direct": true,
                "changes": 0,
                "duration": "3h 20m",
                "operator": null,
                "available": true,
                "arrival_time": "2027-03-14T13:51:00",
                "cheapest_fare": {
                    "price": 304.83,
                    "currency": "USD",
                    "booking_fee": 0,
                    "tickets_left": 172,
                    "original_price": 304.83
                },
                "train_numbers": [],
                "departure_time": "2027-03-14T10:31:00",
                "arrival_station": {
                    "code": "FR3466",
                    "name": "Paris Gare du Nord",
                    "latitude": 48.88099883257269,
                    "city_code": "PAR",
                    "longitude": 2.356107777136769,
                    "country_code": "FR"
                },
                "duration_minutes": 200,
                "departure_station": {
                    "code": "GB3467",
                    "name": "London St. Pancras International",
                    "latitude": 51.5306243,
                    "city_code": "LON",
                    "longitude": -0.1255274,
                    "country_code": "GB"
                },
                "operator_logo_url": "https://example.com/logo.png"
            }
        ],
        "currency": "USD",
        "has_more": false
    },
    "meta": {
        "billable": true,
        "endpoint_family": "bus_search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Unexpected Upstream Format | Trip.com answered with a format Scrappa does not know. This response is not billable. |
| 503 | Upstream Unavailable | Trip.com did not answer or no capacity was free. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)