{
"results": [
{
"id": "578A19E791A33F37C5189F95D428ED1E",
"name": "Children's Creativity Museum",
"address": "221 4th St, San Francisco, CA 94103, United States",
"phone_number": "+14158203320",
"website": "http://www.creativity.org/",
"location": {
"lat": 37.783366,
"lng": -122.402325
},
"types": [
"museum",
"tourist_attraction"
]
}
]
}
curl --location --request GET 'https://pr213-testing.zylalabs.com/api/3898/trueway+places+api/4605/findplacebytext?text=Children's Creativity Museum&language=en' --header 'Authorization: Bearer YOUR_API_KEY'
{
"results": [
{
"id": "1DE9131FF814DC997C6EEAF351D618EF",
"name": "Funny Library Coffee Shop",
"address": "250 4th St, San Francisco, CA 94103, USA",
"phone_number": "+14155346500",
"website": "https://virginhotels.com/san-francisco/dine-and-drink/funny-library/",
"location": {
"lat": 37.782442,
"lng": -122.402157
},
"types": [
"cafe",
"food",
"store"
],
"distance": 104
},
{
"id": "0BF71988AE26A020BCD7E06E8E42ED22",
"name": "Joyride Pizza - Yerba Buena Gardens",
"address": "730 Howard St, San Francisco, CA 94103, USA",
"phone_number": "+14152952914",
"website": "http://www.joyridepizza.com/",
"location": {
"lat": 37.784506,
"lng": -122.401944
},
"types": [
"bar",
"cafe",
"food",
"restaurant"
],
"distance": 131
}
]
}
curl --location --request GET 'https://pr213-testing.zylalabs.com/api/3898/trueway+places+api/4606/findplacesnearby?location=37.783366,-122.402325&radius=1000&language=en' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the TrueWay Places API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
(Save 2 months with annual billing 🎉)
Trusted by leading companies
The Places API lets you search for places.
You can search for places either by proximity or a text string.
A FindPlaceByText request takes a text parameter and returns a place.
Required parameters:
text - Text input that identifies the search target, such as a name or address.Optional parameters:
language - The two-letter language code in which to return results (ISO 639-1).bounds - Prefer results in a specified rectangular area. Format: south,west,north,east. Coordinates: decimal degrees.A FindPlacesNearby lets you search for places around location within a specified radius.
Required parameters:
location - The latitude/longitude around which to retrieve places.Optional parameters:
radius - The distance (in meters) within which to return results. Maximum: 10000 m.type - The type of places that are returned (see the list of allowed types below.).language - The two-letter language code in which to return results (ISO 639-1).The service returns a list of places along with details information about each place.
A Place contains the following fields:
The FindPlaceByText endpoint accepts parameters like text, language, and bounds. The FindPlacesNearby endpoint uses location, radius, type, and language. These parameters allow users to customize their searches effectively.
The response data is structured as a JSON object containing a "results" array. Each element in the array represents a place with its associated fields, making it easy to parse and utilize the information programmatically.
Both endpoints provide information about various places, including restaurants, museums, parks, and more. Users can search for specific types of places or explore nearby options based on their location.
Data accuracy is maintained through regular updates and quality checks from multiple sources. The API aggregates information from trusted databases, ensuring users receive reliable and up-to-date place details.
Typical use cases include finding nearby restaurants, locating tourist attractions, or searching for specific services like hospitals or banks. Developers can integrate this data into apps for navigation, travel planning, or local discovery.
Users can utilize the returned data by displaying place information in applications, filtering results based on types or distance, and linking to external websites for more details. This enhances user experience in location-based services.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund