Get target geography

List target geography

curl --request GET \
  --url https://api.app.hrizn.io/v1/public/site/target-geography \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.app.hrizn.io/v1/public/site/target-geography"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/site/target-geography', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/site/target-geography', 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.app.hrizn.io/v1/public/site/target-geography",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

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

curl_close($curl);

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

{
  "data": {
    "targets": [
      {
        "id": "a6cc855e-5679-4e35-acc2-c3a110c7a0a1",
        "location": "Queens, NY",
        "display_name": "Queens, NY",
        "location_type": "city",
        "geojson": {
          "type": "FeatureCollection",
          "features": ["... GeoJSON polygon data ..."]
        },
        "location_profile": {
          "community_type": "urban",
          "character": "Queens is a vibrant, diverse borough of New York City known for its multicultural neighborhoods and bustling urban environment.",
          "demographics": "Queens is one of the most ethnically diverse urban areas in the world, home to large communities of immigrants from Asia, Latin America, Europe, and the Caribbean.",
          "notable_features": [
            "Flushing Meadows-Corona Park",
            "Citi Field (home of the New York Mets)",
            "JFK International Airport",
            "Diverse ethnic enclaves such as Flushing, Jackson Heights, and Astoria",
            "Museum of the Moving Image",
            "Queens Botanical Garden"
          ],
          "terrain": "Queens features relatively flat terrain with some gently rolling hills, bordered by the East River and Long Island Sound.",
          "lifestyle": "Residents enjoy a fast-paced urban lifestyle with access to extensive public transportation, diverse dining options, cultural festivals, and recreational activities."
        },
        "created_at": "2026-02-17T15:44:28.075277+00:00",
        "updated_at": "2026-02-17T15:44:34.834763+00:00"
      },
      {
        "id": "d2aed358-da67-45e0-9c2f-5878b8c4585f",
        "location": "Southampton, NY",
        "display_name": "Southampton, NY",
        "location_type": "city",
        "geojson": {
          "type": "FeatureCollection",
          "features": ["... GeoJSON polygon data ..."]
        },
        "location_profile": {
          "community_type": "mixed",
          "character": "Southampton, NY is a historic and affluent seaside community known for its blend of charming village atmosphere and upscale resort lifestyle.",
          "demographics": "The population includes a mix of wealthy second-home owners, retirees, artists, and local service workers.",
          "notable_features": [
            "Coopers Beach — a renowned public beach with pristine sand and ocean views",
            "Southampton Village Historic District featuring colonial architecture",
            "The Parrish Art Museum showcasing regional art",
            "Main Street with boutique shops, fine dining, and galleries"
          ],
          "terrain": "Southampton is located on the eastern end of Long Island, featuring gently rolling terrain with sandy beaches, coastal bluffs, salt marshes, and farmland.",
          "lifestyle": "Residents enjoy a leisurely, upscale coastal lifestyle with activities such as boating, beachgoing, golfing, and attending cultural events."
        },
        "created_at": "2026-01-09T21:36:28.932329+00:00",
        "updated_at": "2026-02-01T19:52:06.479748+00:00"
      }
    ]
  }
}

GET

site

target-geography

List target geography

curl --request GET \
  --url https://api.app.hrizn.io/v1/public/site/target-geography \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.app.hrizn.io/v1/public/site/target-geography"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/site/target-geography', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/site/target-geography', 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.app.hrizn.io/v1/public/site/target-geography",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

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

curl_close($curl);

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

{
  "data": {
    "targets": [
      {
        "id": "a6cc855e-5679-4e35-acc2-c3a110c7a0a1",
        "location": "Queens, NY",
        "display_name": "Queens, NY",
        "location_type": "city",
        "geojson": {
          "type": "FeatureCollection",
          "features": ["... GeoJSON polygon data ..."]
        },
        "location_profile": {
          "community_type": "urban",
          "character": "Queens is a vibrant, diverse borough of New York City known for its multicultural neighborhoods and bustling urban environment.",
          "demographics": "Queens is one of the most ethnically diverse urban areas in the world, home to large communities of immigrants from Asia, Latin America, Europe, and the Caribbean.",
          "notable_features": [
            "Flushing Meadows-Corona Park",
            "Citi Field (home of the New York Mets)",
            "JFK International Airport",
            "Diverse ethnic enclaves such as Flushing, Jackson Heights, and Astoria",
            "Museum of the Moving Image",
            "Queens Botanical Garden"
          ],
          "terrain": "Queens features relatively flat terrain with some gently rolling hills, bordered by the East River and Long Island Sound.",
          "lifestyle": "Residents enjoy a fast-paced urban lifestyle with access to extensive public transportation, diverse dining options, cultural festivals, and recreational activities."
        },
        "created_at": "2026-02-17T15:44:28.075277+00:00",
        "updated_at": "2026-02-17T15:44:34.834763+00:00"
      },
      {
        "id": "d2aed358-da67-45e0-9c2f-5878b8c4585f",
        "location": "Southampton, NY",
        "display_name": "Southampton, NY",
        "location_type": "city",
        "geojson": {
          "type": "FeatureCollection",
          "features": ["... GeoJSON polygon data ..."]
        },
        "location_profile": {
          "community_type": "mixed",
          "character": "Southampton, NY is a historic and affluent seaside community known for its blend of charming village atmosphere and upscale resort lifestyle.",
          "demographics": "The population includes a mix of wealthy second-home owners, retirees, artists, and local service workers.",
          "notable_features": [
            "Coopers Beach — a renowned public beach with pristine sand and ocean views",
            "Southampton Village Historic District featuring colonial architecture",
            "The Parrish Art Museum showcasing regional art",
            "Main Street with boutique shops, fine dining, and galleries"
          ],
          "terrain": "Southampton is located on the eastern end of Long Island, featuring gently rolling terrain with sandy beaches, coastal bluffs, salt marshes, and farmland.",
          "lifestyle": "Residents enjoy a leisurely, upscale coastal lifestyle with activities such as boating, beachgoing, golfing, and attending cultural events."
        },
        "created_at": "2026-01-09T21:36:28.932329+00:00",
        "updated_at": "2026-02-01T19:52:06.479748+00:00"
      }
    ]
  }
}

Returns all target geography locations configured for the site. Each target includes an AI-generated location profile describing the community, demographics, and lifestyle of the area. The AI uses these profiles to localize generated content. Scope required: site:read

{
  "data": {
    "targets": [
      {
        "id": "a6cc855e-5679-4e35-acc2-c3a110c7a0a1",
        "location": "Queens, NY",
        "display_name": "Queens, NY",
        "location_type": "city",
        "geojson": {
          "type": "FeatureCollection",
          "features": ["... GeoJSON polygon data ..."]
        },
        "location_profile": {
          "community_type": "urban",
          "character": "Queens is a vibrant, diverse borough of New York City known for its multicultural neighborhoods and bustling urban environment.",
          "demographics": "Queens is one of the most ethnically diverse urban areas in the world, home to large communities of immigrants from Asia, Latin America, Europe, and the Caribbean.",
          "notable_features": [
            "Flushing Meadows-Corona Park",
            "Citi Field (home of the New York Mets)",
            "JFK International Airport",
            "Diverse ethnic enclaves such as Flushing, Jackson Heights, and Astoria",
            "Museum of the Moving Image",
            "Queens Botanical Garden"
          ],
          "terrain": "Queens features relatively flat terrain with some gently rolling hills, bordered by the East River and Long Island Sound.",
          "lifestyle": "Residents enjoy a fast-paced urban lifestyle with access to extensive public transportation, diverse dining options, cultural festivals, and recreational activities."
        },
        "created_at": "2026-02-17T15:44:28.075277+00:00",
        "updated_at": "2026-02-17T15:44:34.834763+00:00"
      },
      {
        "id": "d2aed358-da67-45e0-9c2f-5878b8c4585f",
        "location": "Southampton, NY",
        "display_name": "Southampton, NY",
        "location_type": "city",
        "geojson": {
          "type": "FeatureCollection",
          "features": ["... GeoJSON polygon data ..."]
        },
        "location_profile": {
          "community_type": "mixed",
          "character": "Southampton, NY is a historic and affluent seaside community known for its blend of charming village atmosphere and upscale resort lifestyle.",
          "demographics": "The population includes a mix of wealthy second-home owners, retirees, artists, and local service workers.",
          "notable_features": [
            "Coopers Beach — a renowned public beach with pristine sand and ocean views",
            "Southampton Village Historic District featuring colonial architecture",
            "The Parrish Art Museum showcasing regional art",
            "Main Street with boutique shops, fine dining, and galleries"
          ],
          "terrain": "Southampton is located on the eastern end of Long Island, featuring gently rolling terrain with sandy beaches, coastal bluffs, salt marshes, and farmland.",
          "lifestyle": "Residents enjoy a leisurely, upscale coastal lifestyle with activities such as boating, beachgoing, golfing, and attending cultural events."
        },
        "created_at": "2026-01-09T21:36:28.932329+00:00",
        "updated_at": "2026-02-01T19:52:06.479748+00:00"
      }
    ]
  }
}

The geojson field contains GeoJSON FeatureCollection data with polygon boundaries for the location. The location_profile provides AI-generated community information including demographics, notable features, terrain, and lifestyle details.

Authorizations

X-API-Key

string

header

required

Your Hrizn API key (prefix hzk_)

Response

Target geography locations

data

object

Hide child attributes

data.targets

object[]

Hide child attributes

data.targets.id

string<uuid>

data.targets.location

string | null

data.targets.display_name

string | null

data.targets.location_type

enum<string> | null

Available options:

zipcode,

city,

custom

data.targets.geojson

object | null

data.targets.location_profile

object | null

Hide child attributes

data.targets.location_profile.community_type

string | null

data.targets.location_profile.character

string | null

data.targets.location_profile.demographics

string | null

data.targets.location_profile.notable_features

string[] | null

data.targets.location_profile.terrain

string | null

data.targets.location_profile.lifestyle

string | null

data.targets.created_at

string<date-time>

data.targets.updated_at

string<date-time>

Last modified on February 28, 2026

Get marketing artifacts

Get staff members

Overview

IdeaClouds

Content Intelligence

Content

Content Types

Compliance

Content Tools

Inventory

Site

Dealership Config

Social

Webhooks

Reference

Health

IdeaClouds

Content

Compliance

Content Tools

Inventory

Site

Webhooks

Content Intelligence

Reference

Social

Authorizations

Response