Developer Documentation

TrendyReports API

Integrate automated market reports directly into your CRM, website, or application. Generate reports programmatically and automate your market intelligence workflow.

RESTful API

Clean, predictable resource-oriented endpoints with JSON responses.

API Key Auth

Simple API key authentication. Generate keys from your dashboard.

Webhooks

Get notified when reports are ready or schedules run.

Rate Limiting

Fair rate limits with clear headers. Pro plans get higher limits.

Quick Start

1. Get Your API Key

Generate an API key from your dashboard under Settings → API. Keep this key secure and never expose it in client-side code.

# Include in request headers
Authorization: Bearer tr_live_xxxxxxxxxxxx

2. Make Your First Request

Generate a market report with a simple POST request. The API will return a report ID that you can use to retrieve the PDF.

curl -X POST \
https://api.trendyreports.com/v1/reports/generate \
-H "Authorization: Bearer tr_live_xxx" \
-H "Content-Type: application/json" \
-d '{"report_type": "market_snapshot", "zip_codes": ["94103"]}'

API Endpoints

POST/v1/reports/generate
Reports
GET/v1/reports/{id}
Reports
GET/v1/reports
Reports
POST/v1/schedules
Schedules
GET/v1/schedules
Schedules
PATCH/v1/schedules/{id}
Schedules
GET/v1/account
Account

Full API reference documentation coming soon. Contact us for early access.

Available Report Types

market_snapshot

Market Snapshot

Area-wide market trends with charts and statistics

new_listings

New Listings Gallery

Photo-rich showcase of recent listings

featured_listings

Featured Listings

Curated property highlights

neighborhood

Neighborhood Analysis

Hyperlocal market intelligence

price_trends

Price Trends

Historical price data visualization

custom

Custom Report

Build your own with our report builder

Webhooks

Subscribe to events and get notified when important things happen. Perfect for building automated workflows.

report.completedReport is ready for download
report.failedReport generation failed
schedule.executedScheduled report was sent
// Webhook payload example
{
"event": "report.completed",
"data": {
"report_id": "rpt_abc123",
"pdf_url": "https://...",
"created_at": "2025-12-17T..."
}
}

Ready to integrate?

API access is available on Pro and Enterprise plans. Contact us to get started.