---
title: "Complete an address into coordinates for Sonic Drive-In store search"
method: GET
path: "/sonic/location-suggest"
tags: ["Sonic"]
---

# Complete an address into coordinates for Sonic Drive-In store search

`GET /sonic/location-suggest`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sonic/location-suggest`
- Auth: API key in header `x-api-key`

Completes a partial address, place, city, state or ZIP into ranked matches, each already carrying the latitude and longitude that GET /sonic/nearby takes -- so a caller can run a Sonic restaurant search from free text instead of coordinates. Each suggestion's layer describes its granularity and is one of `address`, `locality`, `state`, `postalCode` or `place`, and confidence is one of `exact`, `interpolated` or `fallback`. Results are restricted to one country (default US). A query that matches nothing returns an empty suggestions array with count 0, not an error.

## Query parameters

- `query` string, required
- `limit` integer
- `country` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SonicLocationSuggestResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SonicLocationSuggestResponse
    - `count` integer
    - `country` string
    - `fetched_at` string
    - `limit` integer
    - `query` string
    - `source_url` string
    - `suggestions` SonicLocationSuggestion[]
      - `city` string
      - `confidence` string: Confidence is the geocoder's own match confidence: "exact", "interpolated", or "fallback".
      - `country` string
      - `country_code` string
      - `county` string
      - `formatted_address` string
      - `label` string
      - `latitude` number
      - `layer` string: Layer is the match's granularity: "address", "locality", "state", "postalCode", or "place".
      - `longitude` number
      - `number` string
      - `postal_code` string
      - `state` string
      - `state_code` string
      - `street` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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