# Cobroker API

> CRE tools for AI agents. REST API for commercial real estate — projects, properties, demographics, places search, AI research.

## Docs

- [API Overview](https://cobroker.ai/developers): Overview of Cobroker's REST API for AI agents — capabilities, authentication, and quick start.
- [llms.txt](https://cobroker.ai/llms.txt): Quick-start guide with authentication, endpoints, and cURL examples.
- [Authentication](https://cobroker.ai/developers#endpoints): All requests require X-Agent-User-Id and X-Agent-Secret headers.

## API Reference — Projects

- [List Projects](https://app.cobroker.ai/api/agent/openclaw/projects): GET /projects — List all CRE projects with name, description, property count, and URLs.
- [Create Project](https://app.cobroker.ai/api/agent/openclaw/projects): POST /projects — Create a project with properties, custom fields, and automatic geocoding. Max 50 properties per request.
- [Get Project Details](https://app.cobroker.ai/api/agent/openclaw/projects/{id}): GET /projects/{id} — Get full project details including properties, columns, and field values.
- [Update Project](https://app.cobroker.ai/api/agent/openclaw/projects/{id}): PATCH /projects/{id} — Update project name, description, or public visibility.
- [Delete Project](https://app.cobroker.ai/api/agent/openclaw/projects/{id}): DELETE /projects/{id} — Delete project and all associated properties, images, and documents.

## API Reference — Properties

- [Add Properties](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/properties): POST /projects/{id}/properties — Add properties with custom fields. New field names auto-create columns.
- [Update Properties](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/properties): PATCH /projects/{id}/properties — Update property addresses or field values. Address changes trigger re-geocoding.
- [Delete Properties](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/properties): DELETE /projects/{id}/properties — Remove properties by ID.

## API Reference — Demographics, Psychographics & Market Data

- [List Data Types](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/demographics): GET /projects/{id}/demographics — List all available ESRI GeoEnrichment data types across 15+ categories.
- [Add Data](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/demographics): POST /projects/{id}/demographics — Enrich properties with ESRI GeoEnrichment data. Modes: radius (miles), drive-time (minutes), walk-time (minutes).

### Available Data Categories
- **Core Demographics**: population, median_age, households, population_density, household_size, daytime_population
- **Income**: income, per_capita_income, avg_household_income, disposable_income, income brackets ($25K–$250K+)
- **Employment**: total_employment, retail_jobs, healthcare_jobs, office_jobs, food_service_jobs, manufacturing_jobs, construction_jobs, education_jobs, unemployment_rate
- **Housing**: median_home_value, median_rent, owner_occupied, renter_occupied, vacant_housing, housing_after_2010, avg_home_value, median_year_built
- **Age Groups**: age_0_4, age_5_17, age_18_24, age_25_34, age_35_44, age_45_54, age_55_64, age_65_74, age_75_plus, working_age
- **Race/Ethnicity**: white_population, black_population, hispanic_population, asian_population, two_or_more_races, diversity_index
- **Tapestry Psychographics**: tapestry_segment (dominant lifestyle segment from 67 types, e.g. "Laptops and Lattes", "Metro Renters", "Savvy Suburbanites"), tapestry_top3 (top 3 segments), lifemode_group (LifeMode classification)
- **Consumer Spending**: restaurant_spending, retail_spending, entertainment_spending, grocery_spending, spending_potential_index (100 = national avg)
- **Market Potential Index**: dining_propensity, shopping_propensity, fitness_propensity (100 = national avg propensity)
- **Business Data**: business_count, employee_count, retail_trade_businesses, food_service_businesses (by NAICS sector)
- **Crime Indexes**: total_crime_index, property_crime_index, personal_crime_index (100 = national avg risk)
- **Retail Marketplace**: retail_demand, retail_supply_gap, food_service_demand (supply vs demand gap analysis by NAICS)
- **Commute**: avg_commute_time, work_from_home_pct, public_transit_pct
- **Education**: bachelors_degree_pct, graduate_degree_pct
- **Health Insurance**: uninsured_rate

## API Reference — Foot Traffic & Location Intelligence

- [Get Traffic Data](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/traffic): POST /projects/{id}/traffic — Enrich properties with foot traffic and visitor analytics data.

### Available Traffic Data Types
- **Visitation Metrics**: visits (estimated foot traffic counts), visit_trends (monthly/weekly trends), visits_by_hour (hourly distribution), visits_by_day (day-of-week patterns), visit_frequency (repeat visitor analysis)
- **Dwell Time**: dwell_time (visitor duration segments — quick stops vs extended visits)
- **Trade Area**: trade_area (true trade area from visitor origins by Census Block Group), drive_time_trade_area (drive-time based boundaries)
- **Competitive**: rankings (property-level competitive rankings), competitive_benchmark (traffic comparison with nearby/similar properties), nearby_activity (foot traffic in surrounding area)
- **Retail Sales**: transaction_volume (estimated transaction counts), avg_ticket_size (average purchase amount), sales_trends (revenue trends over time), daily_sales (day-level revenue estimates)
- **Visitor Journey**: visitor_origins (where visitors come from), cross_shopping (other places visitors frequent), favorite_chains (top chain visits by property visitors)

## API Reference — AI Research Enrichment

- [Submit Enrichment](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/enrichment): POST /projects/{id}/enrichment — Submit an AI research question for each property. Async processing with 4 tiers: base (~15-100s), core (~1-5min), pro (~3-9min), ultra (~5-25min).
- [Check Enrichment Status](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/enrichment?columnId={columnId}): GET /projects/{id}/enrichment — Poll for enrichment results. Returns status and completed property values.

## API Reference — Places Search

- [Search Places](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/places/search): POST /projects/{id}/places/search — Search Google Places for businesses, chains, and locations. Supports preview mode, nationwide region search (up to 400 results), and saving as properties or map layers.
- [Nearby Analysis](https://app.cobroker.ai/api/agent/openclaw/projects/{id}/places/nearby): POST /projects/{id}/places/nearby — Analyze what's near each property. Modes: "nearest" (find closest matching place) or "count" (count place types within radius).

## OpenClaw Integration

- [OpenClaw Integration Guide](https://cobroker.ai/openclaw): How to install the Cobroker skill in OpenClaw — skill file, environment variables, example conversations, and capabilities overview.
- Skill name: `cobroker-projects`
- Environment variables: `COBROKER_AGENT_USER_ID`, `COBROKER_AGENT_SECRET`
- Capabilities: projects CRUD, ESRI demographics (58+ types), Google Places, foot traffic, AI research, maps

## OpenAPI Specification

- [OpenAPI YAML](https://cobroker.ai/.well-known/openapi.yaml): OpenAPI 3.0 specification in YAML format.
- [OpenAPI JSON](https://cobroker.ai/.well-known/openapi.json): OpenAPI 3.0 specification in JSON format.

## Machine-Readable Resources

- [MCP Server Config](https://cobroker.ai/.well-known/mcp.json): MCP discovery file for Claude Code, Cursor, and other MCP clients.
- [llms.txt Quick Start](https://cobroker.ai/llms.txt): Concise API overview optimized for LLM consumption.
- [llms-full.txt](https://cobroker.ai/llms-full.txt): Full documentation index (this file).