# Walk Score API

> Walk Score returns walkability, bike, and transit scores for an address, available as a workflow and API.

Walk Score returns Walk, Transit, and Bike Scores plus neighborhood details for a street address with city and state. Get walk score also returns the matched address, score descriptions, a walkability summary, and nearby amenities when shown.

- Page: https://fous.com/tools/walk-score
- Handle: `@walk-score`
- Category: [Real estate](https://fous.com/tools/category/real-estate)
- Source website: https://walkscore.com
- Last verified: Sep 29, 2026

## Methods

### Get walk score

Operation `get_walk_score`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the Walk, Transit and Bike Scores and neighborhood details for a street address. Unpublished scores are null; unresolved or mismatched addresses are not found.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `address` | string | yes | `"1600 Pennsylvania Ave NW, Washington, DC"` | Street address with city and state, for example 1600 Pennsylvania Ave NW, Washington, DC. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Street address with city and state, for example 1600 Pennsylvania Ave NW, Washington, DC.",
      "examples": [
        "1600 Pennsylvania Ave NW, Washington, DC",
        "350 5th Ave, New York, NY",
        "250 N 10th St, Laramie, WY"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "address": "1600 Pennsylvania Ave NW, Washington, DC"
    },
    {
      "address": "350 5th Ave, New York, NY"
    },
    {
      "address": "250 N 10th St, Laramie, WY"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `address` | string | `"1600 Pennsylvania Avenue Northwest, Washington, DC 20500"` | Matched street address, city, state and postal code. |
| `summary` | string or null | `"This location is a Walker’s Paradise so daily errands do not require a car."` | One-sentence walkability summary shown for this location. |
| `bike_score` | integer or null | `80` | Bike Score from 0 to 100, or null if unpublished. |
| `walk_score` | integer or null | `95` | Walk Score from 0 to 100, or null if unpublished. |
| `transit_score` | integer or null | `100` | Transit Score from 0 to 100, or null if unpublished. |
| `score_page_link` | string | `"https://www.walkscore.com/score/1600-pennsylvania-ave-nw-washington-dc-20500"` | Link to the matched address score page. |
| `bike_description` | string or null | `"Very Bikeable"` | Bike Score description, or null if unpublished. |
| `walk_description` | string or null | `"Walker’s Paradise"` | Walk Score description, or null if unpublished. |
| `transit_description` | string or null | `"Rider’s Paradise"` | Transit Score description, or null if unpublished. |
| `nearby_amenities_summary` | string or null | `"Nearby parks include East Executive Park, General William Tecumseh Sherman Monument and Presidents Park."` | Nearby amenities summary when shown. |

**Example input**

```json
{
  "address": "1600 Pennsylvania Ave NW, Washington, DC"
}
```

**Example output**

```json
{
  "address": "1600 Pennsylvania Avenue Northwest, Washington, DC 20500",
  "summary": "This location is a Walker’s Paradise so daily errands do not require a car.",
  "bike_score": 80,
  "walk_score": 95,
  "transit_score": 100,
  "score_page_link": "https://www.walkscore.com/score/1600-pennsylvania-ave-nw-washington-dc-20500",
  "bike_description": "Very Bikeable",
  "walk_description": "Walker’s Paradise",
  "transit_description": "Rider’s Paradise",
  "nearby_amenities_summary": "Nearby parks include East Executive Park, General William Tecumseh Sherman Monument and Presidents Park."
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@walk-score",
  "visibility": "public",
  "operation": "get_walk_score",
  "version": 1,
  "input": {
    "address": "1600 Pennsylvania Ave NW, Washington, DC"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@walk-score\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_walk_score\",\n  \"version\": 1,\n  \"input\": {\n    \"address\": \"1600 Pennsylvania Ave NW, Washington, DC\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@walk-score",
  "visibility": "public",
  "operation": "get_walk_score",
  "version": 1,
  "input": {
    "address": "1600 Pennsylvania Ave NW, Washington, DC"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/walk-score`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_walk_score`: Get Walk Score. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-walk-score https://api.fous.com/mcp/tools/walk-score --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare walkability across property locations
- Assess transit access near an address
- Review bike access for real estate listings
- Summarize nearby amenities for a location

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Walk Score tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Walk Score account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from walkscore.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What are the walk, transit, and bike scores for an address?

Get walk score returns these scores and their descriptions when published; unpublished scores are null.

### What neighborhood details are available for an address?

Get walk score returns a walkability summary and nearby amenities summary when shown.

## Related

- [Zillow API](https://fous.com/tools/zillow.md): Zillow provides homes for sale, rental listings, home details, estimates, and housing market figures; rental details, history, schools, estimates, and market figures may be missing or reflect different reporting dates.
- [OpenStreetMap API](https://fous.com/tools/openstreetmap.md): OpenStreetMap returns place coordinates, address details, nearby readable place information, and ordered place search results from contributor-created data; results reflect mapped features and may be incomplete or differ from landmarks.
- [US Census Bureau API](https://fous.com/tools/us-census-bureau.md): US Census Bureau returns statistics from varying Census years, population estimates through July 1, and address geographies using Census vintages that may differ from representation.
- [Google Maps API](https://fous.com/tools/google-maps.md): Google Maps returns nearby places, public place details, up to 100 public reviews, and up to three routes; transit options vary by departure time.
- [Realtor.com API](https://fous.com/tools/realtor-com.md): Realtor.com returns home listings for sale, rent, or recently sold, property details and estimates, and local agent profiles; some fields or sold prices may be missing.
- [Apartments.com API](https://fous.com/tools/apartments-com.md): Apartments.com returns U.S. apartments and homes matching location and optional filters, plus community details; rent and availability may be missing or change.
- [Redfin API](https://fous.com/tools/redfin.md): Redfin provides publicly listed homes, details, estimates, and latest area market figures with up to 12 months of sale prices; some data may be unavailable.
- [GreatSchools API](https://fous.com/tools/greatschools.md): GreatSchools provides school ratings and profile facts, plus nearby US school search results within five miles; unpublished details may be unavailable, and distances are straight-line estimates.
- [All Real estate tools](https://fous.com/tools/category/real-estate)