Yelp API endpoint
Resolves a free-form address into structured location data (coordinates, city, state, zip, county). Not business-scoped.
/yelp/geocodeQuery parameters:
address (required): a free-form address to resolve, e.g. 1600 Amphitheatre Parkway, Mountain View, CA.Unlike the other Yelp endpoints in this API, this one is not business-scoped — it resolves any free-form address into structured location data (coordinates, city, state, zip, county).
| Field | In the sample | Value in the sample |
|---|---|---|
| address | Has a value | |
| display_name | Has a value | |
| address_line_1 | Has a value | |
| city | Has a value | “Mountain View” |
| state | Has a value | “CA” |
| postal_code | Has a value | |
| country | Has a value | “US” |
| county | Has a value | “Santa Clara County” |
| coordinates.latitude | Has a value | |
| coordinates.longitude | Has a value | |
| yelp_available | Has a value | true |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| address | string | Yes | Free-form address to geocode | 1600 Amphitheatre Parkway, Mountain View, CA | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yelp/geocode?address=1600+Amphitheatre+Parkway%2C+Mountain+View%2C+CA" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"address": "1600 Amphitheatre Parkway, Mountain View, CA",
"display_name": "Mountain View, CA",
"address_line_1": "1600 Amphitheatre Pkwy",
"city": "Mountain View",
"state": "CA",
"postal_code": "94043",
"country": "US",
"county": "Santa Clara County",
"coordinates": {
"latitude": 37.4224864,
"longitude": -122.0855962
},
"yelp_available": true
}
}Request schema
No body schema
Response schema
#/definitions/yelp.mobileGeocodeResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yelp.MobileGeocodeResponse | No | ||||
| data.address | string | No | 1600 Amphitheatre Parkway, Mountain View, CA | |||
| data.address_line_1 | string | No | ||||
| data.city | string | No | ||||
| data.coordinates | yelp.Coordinates | No | ||||
| data.coordinates.latitude | number | No | ||||
| data.coordinates.longitude | number | No | ||||
| data.country | string | No | ||||
| data.county | string | No | ||||
| data.display_name | string | No | ||||
| data.postal_code | string | No | ||||
| data.state | string | No | ||||
| data.yelp_available | boolean | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/yelp/geocode?address=1600+Amphitheatre+Parkway%2C+Mountain+View%2C+CA" \
-H "x-api-key: $CRAWLORA_API_KEY"