> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Get target geography
> Returns all target geography locations with boundaries and AI-generated profiles
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`
```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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.
## OpenAPI
````yaml GET /site/target-geography
openapi: 3.1.0
info:
title: Hrizn Public API
version: 1.2.0
description: >
The Hrizn Public API allows partners to programmatically create content,
manage inventory descriptions, and integrate with the Hrizn platform.
All endpoints are prefixed with `/public` and require an API key passed via
the `X-API-Key` header (except the health check).
contact:
email: support@hrizn.io
servers:
- url: https://api.app.hrizn.io/v1/public
description: Production
security:
- apiKeyAuth: []
tags:
- name: IdeaClouds
description: Create and manage AI-powered keyword research
- name: Content Intelligence
description: AI-powered content gap analysis and recommendations
- name: Content
description: Generate content from IdeaClouds
- name: Compliance
description: Run OEM compliance checks on content
- name: Content Tools
description: Generate SEO metadata, schemas, and social snippets
- name: Inventory
description: Access vehicle data and AI descriptions
- name: Site
description: View dealership details and configuration
- name: Webhooks
description: Manage webhook subscriptions for real-time events
- name: Reference
description: Look up available types, scopes, and events
- name: Social
description: >-
Zernio-backed social posting and reviews across all connected platforms
(X, Facebook, Instagram, LinkedIn, Google Business Profile)
- name: Health
description: Health check (no authentication)
paths:
/site/target-geography:
get:
tags:
- Site
summary: List target geography
description: >-
Returns all target geography locations with boundaries and AI-generated
location profiles.
operationId: getTargetGeography
responses:
'200':
description: Target geography locations
content:
application/json:
schema:
$ref: '#/components/schemas/TargetGeographyResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'500':
$ref: '#/components/responses/InternalError'
components:
schemas:
TargetGeographyResponse:
type: object
properties:
data:
type: object
properties:
targets:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
location:
type: string
nullable: true
display_name:
type: string
nullable: true
location_type:
type: string
enum:
- zipcode
- city
- custom
nullable: true
geojson:
type: object
nullable: true
location_profile:
type: object
nullable: true
properties:
community_type:
type: string
nullable: true
character:
type: string
nullable: true
demographics:
type: string
nullable: true
notable_features:
type: array
items:
type: string
nullable: true
terrain:
type: string
nullable: true
lifestyle:
type: string
nullable: true
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: validation_error
message:
type: string
example: 'keyword: Required'
details:
type: object
request_id:
type: string
responses:
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Forbidden:
description: API key lacks required scope
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Your Hrizn API key (prefix hzk_)
````