---
title: "athome API: Autocomplete | Perceptlayer"
description: "Autocomplete from athome as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/athome/autocomplete
---

[APIs](https://perceptlayer.com/apis) / [athome](https://perceptlayer.com/apis/athome) / Autocomplete

# athome: Autocomplete

Autocomplete from athome as JSON. 1 credit per successful call.

GET `/v1/athome/autocomplete`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `keyword` | string | Required | Up to 40 characters |
| `type` | string | Optional | city, station |
| `prefecture` | string | Optional | hokkaido, aomori, iwate, miyagi, akita, yamagata, fukushima, ibaraki, tochigi, gunma, saitama, chiba, tokyo, kanagawa, niigata, toyama, ishikawa, fukui, yamanashi, nagano, gifu, shizuoka, aichi, mie, shiga, kyoto, osaka, hyogo, nara, wakayama, tottori, shimane, okayama, hiroshima, yamaguchi, tokushima, kagawa, ehime, kochi, fukuoka, saga, nagasaki, kumamoto, oita, miyazaki, kagoshima, okinawa |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/athome/autocomplete?keyword=%E6%96%B0%E5%AE%BF&type=city&prefecture=tokyo" \
  -H "X-API-Key: $API_KEY"
```

[Run this endpoint in the playground](https://perceptlayer.com/apis/athome?try=autocomplete#playground) with your own parameters. 1 credit per successful call; failed calls are free.