Business Data

Search local listings (Google Maps)

Normalized local-listing search from Google Maps — the second provider on this primitive, and unlike the DataForSEO routes beside it this returns Place objects rather than the vendor’s task envelope, names the provider that answered, and bills 2x the provider run’s real cost.

DOES NOT RETURN CONTACT PEOPLE. The provider will also scrape named contacts with work emails; that request is never sent. Contact data is the People primitive, which carries the opt-in gate, the B2B-only field filter and an erasure path.

POST

business

places

Search local listings (Google Maps)

curl --request POST \
  --url https://api.usenaive.ai/v1/business/places/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "location": "<string>",
  "limit": 20
}
'

import requests

url = "https://api.usenaive.ai/v1/business/places/search"

payload = {
    "query": "<string>",
    "location": "<string>",
    "limit": 20
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>', location: '<string>', limit: 20})
};

fetch('https://api.usenaive.ai/v1/business/places/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usenaive.ai/v1/business/places/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'location' => '<string>',
    'limit' => 20
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usenaive.ai/v1/business/places/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"location\": \"<string>\",\n  \"limit\": 20\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.usenaive.ai/v1/business/places/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"location\": \"<string>\",\n  \"limit\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usenaive.ai/v1/business/places/search")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"location\": \"<string>\",\n  \"limit\": 20\n}"

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

{
  "data": [
    {
      "place_id": "<string>",
      "name": "<string>",
      "categories": [
        "<string>"
      ],
      "address": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country_code": "<string>",
      "latitude": 123,
      "longitude": 123,
      "phone": "<string>",
      "website": "<string>",
      "rating": 123,
      "reviews_count": 123,
      "permanently_closed": true,
      "temporarily_closed": true,
      "url": "<string>"
    }
  ],
  "credits_used": 123,
  "credits_remaining": 123,
  "mock": true
}

{
  "error": {
    "message": "<string>",
    "hint": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "hint": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "hint": "<string>",
    "reason": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Headers

Idempotency-Key

string

Deduplicates BOTH the response and the credit deduction: it becomes the ledger reference, so a retried call cannot be charged twice. Max 255 characters.

Body

application/json

query

string

required

What to search for, e.g. 'dentist'.

location

string

required

REQUIRED, not defaulted: Maps results are location-scoped, so a query without one returns whatever Google infers from the datacentre the run happened in — a result the caller cannot reproduce. E.g. 'Austin, Texas'.

limit

number

default:20

1-100. Above 100, Maps itself stops paginating.

Response

OK.

data

object[]

Show child attributes

credits_used

number

3x what the provider run actually cost, empty results included. A failed run is never billed.

credits_remaining

number

provider

enum<string>

Which vendor answered. Named because this primitive has two, and provenance is the subject.

Available options:

apify_google_maps,

dataforseo

mock

boolean

Present and true only when the response came from fixtures.

Search local listings (Google Maps)

curl --request POST \
  --url https://api.usenaive.ai/v1/business/places/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "location": "<string>",
  "limit": 20
}
'

import requests

url = "https://api.usenaive.ai/v1/business/places/search"

payload = {
    "query": "<string>",
    "location": "<string>",
    "limit": 20
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>', location: '<string>', limit: 20})
};

fetch('https://api.usenaive.ai/v1/business/places/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usenaive.ai/v1/business/places/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'location' => '<string>',
    'limit' => 20
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usenaive.ai/v1/business/places/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"location\": \"<string>\",\n  \"limit\": 20\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.usenaive.ai/v1/business/places/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"location\": \"<string>\",\n  \"limit\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usenaive.ai/v1/business/places/search")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"location\": \"<string>\",\n  \"limit\": 20\n}"

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

{
  "data": [
    {
      "place_id": "<string>",
      "name": "<string>",
      "categories": [
        "<string>"
      ],
      "address": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country_code": "<string>",
      "latitude": 123,
      "longitude": 123,
      "phone": "<string>",
      "website": "<string>",
      "rating": 123,
      "reviews_count": 123,
      "permanently_closed": true,
      "temporarily_closed": true,
      "url": "<string>"
    }
  ],
  "credits_used": 123,
  "credits_remaining": 123,
  "mock": true
}

{
  "error": {
    "message": "<string>",
    "hint": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "hint": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "hint": "<string>",
    "reason": "<string>"
  }
}