# FlixBus City Catalog API Documentation

<p><strong>FlixBus City Catalog API Documentation</strong> Browse the FlixBus city catalogue page by page: name, slug, coordinates, short description, activities, transport modes (bus, flixtrain, train) and search_volume, a demand figure that gives a popularity order. FlixBus gives no total: has_more is true when the page is full and next_offset is the offset of the next page.</p>

- **Documentation:** [https://scrappa.co/docs/flixbus-api/flixbus_city_catalog](https://scrappa.co/docs/flixbus-api/flixbus_city_catalog)
- **API group:** FlixBus API
- **Endpoint:** `GET https://scrappa.co/api/flixbus/city-catalog`

## 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 |
| --- | --- | --- | --- |
| `limit` | integer | No | Cities per page, 1 to 200. Defaults to 50. |
| `offset` | integer | No | Number of cities to skip. Use next_offset of the previous page. Defaults to 0. |

## Example response

```json
{
    "data": {
        "count": 3,
        "limit": 3,
        "cities": [
            {
                "id": "40d8f682-8646-11e6-9066-549f350fcb0c",
                "name": "Berlin",
                "slug": "berlin",
                "location": {
                    "lat": 52.525017,
                    "lon": 13.369474
                },
                "legacy_id": 88,
                "activities": [
                    "nightlife-and-entertainment",
                    "arts-and-culture",
                    "luxury-experiences"
                ],
                "description": "Visit iconic landmarks like the Brandenburg Gate and Museum Island; experience vibrant nightlife.",
                "country_code": "DE",
                "search_volume": 37347400,
                "transport_modes": [
                    "bus",
                    "flixtrain"
                ]
            },
            {
                "id": "40d91e53-8646-11e6-9066-549f350fcb0c",
                "name": "Hamburg",
                "slug": "hamburg",
                "location": {
                    "lat": 53.551765,
                    "lon": 10.011657
                },
                "legacy_id": 118,
                "activities": [
                    "nightlife-and-entertainment",
                    "arts-and-culture",
                    "beaches-and-waterfronts"
                ],
                "description": "Discover the Elbphilharmonie, stroll the Reeperbahn, and relax at Elbstrand beach.",
                "country_code": "DE",
                "search_volume": 15500100,
                "transport_modes": [
                    "bus",
                    "flixtrain",
                    "train"
                ]
            },
            {
                "id": "40d901a5-8646-11e6-9066-549f350fcb0c",
                "name": "Munich",
                "slug": "muenchen",
                "location": {
                    "lat": 48.135124,
                    "lon": 11.581981
                },
                "legacy_id": 94,
                "activities": [
                    "arts-and-culture",
                    "festivals-and-events",
                    "luxury-experiences"
                ],
                "description": "Attend Oktoberfest, explore Nymphenburg Palace, and shop along Maximilianstrasse.",
                "country_code": "DE",
                "search_volume": 14556600,
                "transport_modes": [
                    "bus"
                ]
            }
        ],
        "offset": 0,
        "has_more": true,
        "next_offset": 3
    },
    "meta": {
        "billable": true,
        "endpoint_family": "city_catalog"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | FlixBus could not be reached or answered with an unexpected shape. This response is not billable. |

## 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)