# Places Search

{% tabs %}
{% tab title="Curl" %}

```bash
cURL 'https://api.enrich.so/v1/api/places-search?query=Inspiration&page=1' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'
```

{% endtab %}

{% tab title="Javascript" %}

```javascript
const axios = require('axios');

axios.get('https://api.enrich.so/v1/api/places-search?query=Adventure&page=1', {
    headers: {accept: 'application/json', Authorization: 'Bearer <token>'}
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
payload = {'query': 'Adventure', 'page': 1}
headers = {'accept': 'application/json', 'authorization': 'Bearer <token>'}
resp = requests.get('https://api.enrich.so/v1/api/places-search', params=payload, headers=headers)
print (resp.text)
```

{% endtab %}

{% tab title="Java" %}

```java
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.enrich.so/v1/api/places-search?query=Adventure&page=1")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer <token>")
  .build();

Response response = client.newCall(request).execute();
```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.enrich.so/v1/api/places-search?query=Adventure&page=1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

{% endtab %}

{% tab title="Php" %}

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enrich.so/v1/api/places-search?query=Adventure&page=1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

{% endtab %}
{% endtabs %}

## Example response

#### Status Code: <mark style="color:green;">200 OK</mark>

```json
{
    "success": true,
    "message": "Search successfully executed.",
    "data": {
        "request_parameters": {
            "query": "\"Adventure\"",
            "type": "places",
            "current_page": 1,
            "engine": "bing"
        },
        "result": [
            {
                "position": 1,
                "title": "Mystic Adventure Park",
                "address": "123 Forest Lane, Mystic, CT 06355",
                "latitude": 41.354263,
                "longitude": -71.965628,
                "rating": 4.7,
                "ratingCount": 1500,
                "category": "Adventure park",
                "phoneNumber": "(860) 123-4567",
                "website": "https://mysticadventurepark.com",
                "cid": "8471627354578236190"
            },
            {
                "position": 2,
                "title": "SkyHigh Ropes Course",
                "address": "234 Mountain Drive, Ellicottville, NY 14731",
                "latitude": 42.269517,
                "longitude": -78.667846,
                "rating": 4.5,
                "ratingCount": 1120,
                "category": "Ropes course",
                "phoneNumber": "(716) 123-9876",
                "website": "https://skyhighadventures.com",
                "cid": "7493628472946712345"
            },
            {
                "position": 3,
                "title": "Adventure Island Water Park",
                "address": "456 Ocean Breeze Way, Tampa, FL 33612",
                "latitude": 28.052070,
                "longitude": -82.418207,
                "rating": 4.3,
                "ratingCount": 3050,
                "category": "Water park",
                "phoneNumber": "(813) 555-7890",
                "website": "https://adventureisland.com",
                "cid": "6541238976543210789"
            },
            {
                "position": 4,
                "title": "Thrill Zone",
                "address": "789 Adventure Road, Denver, CO 80205",
                "latitude": 39.761850,
                "longitude": -104.975350,
                "rating": 4.0,
                "ratingCount": 540,
                "category": "Amusement center",
                "phoneNumber": "(303) 444-5678",
                "website": "https://thrillzone.com",
                "cid": "5689743216540987321"
            }
        ]
    },
    "total_credits": 200,
    "credits_used": 65.3,
    "credits_remaining": 134.7
}
```

#### Status code: <mark style="color:red;">404 NOT FOUND</mark>

```json
{
    "message": "We couldn't find the results for this query"
}
```
