---
title: "Get Directions"
method: GET
path: "/maps/directions"
tags: ["Google Maps"]
---

# Get Directions

`GET /maps/directions`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/maps/directions`
- Auth: API key in header `X-API-KEY`

Get directions between two locations with route information.
Response format is compatible with SerpAPI's google_maps_directions engine.

## Query parameters

- `origin` string, required
- `destination` string, required
- `mode` 'driving' | 'walking' | 'bicycling' | 'transit' | 'null', nullable
- `hl` string, nullable
- `gl` string, nullable

## Response `200`

- object
  - `search_metadata` object, required
    - `id` string, required
    - `status` string, required
    - `created_at` string, required
    - `engine` string, required
  - `search_parameters` object, required
    - `engine` string, required
    - `start_addr` string, required
    - `end_addr` string, required
    - `travel_mode` string, required
  - `places_info` object[], required
    - `address` string, required
    - `data_id` string, required
    - `gps_coordinates` object, required
      - `latitude` number, required
      - `longitude` number, required
  - `directions` object[], required
    - `travel_mode` string, required
    - `via` string, nullable, required
    - `distance` integer, required
    - `duration` integer, required
    - `formatted_distance` string, required
    - `formatted_duration` string, required
    - `extensions` unknown[], required
      - unknown
    - `trips` object[], required
      - `travel_mode` string, required
      - `distance` integer, required
      - `duration` integer, required
      - `formatted_distance` string, required
      - `formatted_duration` string, required
      - `details` object[], required
        - `title` string, required
        - `action` string, required
        - `distance` integer, required
        - `duration` integer, required
        - `formatted_distance` string, required
        - `formatted_duration` string, required
        - `gps_coordinates` unknown[], required
          - unknown
    - `duration_in_traffic` integer, nullable, required
    - `formatted_duration_in_traffic` string, nullable, required
    - `typical_duration_range` string, nullable, required
  - `status` string, required
  - `routes_count` integer, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)