Intelligence

The intelligence endpoints surface aggregate analytics across the CronDB domain pool: where new registrations are coming from geographically, how a given industry is trending, which competitors you're tracking and how their market sits, and how leads move through your funnel over time.

tip

Most intelligence endpoints require Pro or higher. Geo heatmap is available on Starter; industry PDF reports + competitor tracking are Pro/Enterprise only.

Geo Heatmap

Domain registration counts by country for heatmap visualization. Use to show "where are new fintechs registering this month?" or "where's our industry getting hottest?"

Endpoint

GET /v1/intelligence/geo

Query Parameters

Parameter	Type	Required	Description
industry	string	No	Filter to one industry (saas, fintech, ecommerce, etc.).
days	integer	No	Lookback window. 7–365, default 30.

Example Request

curl -X GET \
  -H "Authorization: Bearer cdb_your_api_key_here" \
  "https://api.crondb.com/v1/intelligence/geo?industry=fintech&days=30"

Response

{
  "countries": [
    {"country": "US", "cnt": 1842},
    {"country": "GB", "cnt": 412},
    {"country": "DE", "cnt": 318},
    {"country": "SG", "cnt": 187}
  ],
  "total": 4520,
  "days": 30,
  "industry": "fintech"
}

country uses ISO 3166-1 alpha-2 codes. The series is ordered by count descending — top of the array is your highest-volume country.

---

Geo Cities (drill-down)

Top 30 cities within a country for the same lookback / industry filter. Use after the user clicks a country on the heatmap.

GET /v1/intelligence/geo/cities?country=US&industry=fintech&days=30

{
  "cities": [
    {"city": "San Francisco", "cnt": 287},
    {"city": "New York", "cnt": 198}
  ],
  "total": 1842,
  "country": "US",
  "days": 30
}

---

Geo Export

CSV export of the full (country, count) series — same filters as /geo. Useful for embedding into your own BI tools.

GET /v1/intelligence/geo/export?industry=fintech&days=30

Returns text/csv with Content-Disposition: attachment.

---

Industry Report

A comprehensive analytics dump for one industry: total active leads, email coverage, average AI confidence, week-over-week growth, 12-week registration trend, country distribution, top domains.

Endpoint

GET /v1/intelligence/report/{industry}

Param	Description
industry	Path parameter. saas, fintech, ecommerce, agency, tech, etc.
format	Query param. Default json. Pass pdf for a print-ready A4 PDF report (rendered with reportlab).

Plan gate: Industry reports require Pro or Enterprise.

Example — JSON

curl -X GET \
  -H "Authorization: Bearer cdb_your_api_key_here" \
  "https://api.crondb.com/v1/intelligence/report/fintech"

{
  "industry": "fintech",
  "summary": {
    "total_leads": 18420,
    "with_email": 12104,
    "email_coverage_pct": 65.7,
    "avg_confidence": 0.84,
    "growth_rate_pct": 8.4
  },
  "weekly_trend": [
    {"week": "2026-02-12", "cnt": 412},
    {"week": "2026-02-19", "cnt": 488}
  ],
  "country_distribution": [
    {"country": "US", "cnt": 6204, "pct": 33.7},
    {"country": "GB", "cnt": 1841, "pct": 10.0}
  ],
  "top_domains": [
    {"domain": "stripe.com", "confidence": 0.97, "summary": "..."},
    {"domain": "plaid.com", "confidence": 0.95, "summary": "..."}
  ]
}

Example — PDF

curl -X GET \
  -H "Authorization: Bearer cdb_your_api_key_here" \
  -o "fintech-report.pdf" \
  "https://api.crondb.com/v1/intelligence/report/fintech?format=pdf"

Returns application/pdf (A4) with charts + tables. Generation is synchronous — expect a few seconds for a popular industry.

---

Competitor Tracking

Watch specific competitor domains and track new entrants in their industries. Plan limits: Pro tracks 10 competitors / Enterprise 100.

List

GET /v1/intelligence/competitors

{
  "competitors": [
    {
      "id": 7,
      "domain": "competitor.com",
      "industry": "fintech",
      "notes": "Direct competitor in EU SMB segment",
      "created_at": "2026-04-01T10:00:00Z",
      "last_checked_at": "2026-05-05T06:00:00Z",
      "alert_email": null,
      "enrichment": {
        "industry": "fintech",
        "country": "GB",
        "confidence": 0.92,
        "website_email": "hello@competitor.com",
        "business_type": "B2B SaaS"
      }
    }
  ],
  "limit": 10,
  "remaining": 9
}

Add

POST /v1/intelligence/competitors

Body Field	Required	Description
domain	Yes	Competitor domain (lowercase, no protocol).
industry	No	Auto-detected from CronDB enrichment if omitted.
notes	No	Free-text.

Returns 409 if the domain is already tracked, 400 if the user is at their plan limit.

Remove

DELETE /v1/intelligence/competitors/{id}

Detail + Analysis

GET /v1/intelligence/competitors/{id}/detail
GET /v1/intelligence/competitors/{id}/analysis

detail returns recent enrichment + 90-day activity. analysis runs a deeper diff (signals shift, tech-stack changes, content delta).

Market Share

GET /v1/intelligence/competitors/market-share

Aggregate analysis of every industry your tracked competitors operate in:

{
  "industries": [
    {
      "industry": "fintech",
      "domain_count": 18420,
      "email_rate": 0.657,
      "avg_confidence": 0.84,
      "new_7d": 412,
      "new_30d": 1804,
      "competitors": ["competitor.com", "rival.io"]
    }
  ],
  "competitors": [
    {
      "id": 7,
      "domain": "competitor.com",
      "industry": "fintech",
      "industry_domain_count": 18420,
      "industry_share_pct": 12.4
    }
  ],
  "total_market_domains": 148000
}

industry_share_pct is the competitor's industry as a share of your total tracked-industry universe — a rough proxy for "how big is the pond this competitor swims in?"

Weekly Digest

GET /v1/intelligence/competitors/digest

Returns the new domains that entered each tracked competitor's industry in the past 7 days. Powers the "5 new competitors detected in your industry" weekly email.

Export

GET /v1/intelligence/competitors/export

CSV download of the full competitor list with current enrichment.

---

Funnel Trends

Aggregate funnel metrics across all your lead lists, plotted over time. Pairs with List Funnel (per-list) — /funnel here is the cross-list rollup.

GET /v1/intelligence/funnel
GET /v1/intelligence/funnel/trends

/funnel returns current totals by stage (discovered → contacted → qualified → converted). /funnel/trends returns weekly snapshots so you can chart conversion-rate movement.

{
  "stages": {
    "discovered": 4820,
    "contacted": 1241,
    "qualified": 388,
    "converted": 67
  },
  "stage_conversion_rates": {
    "discovered_to_contacted": 25.7,
    "contacted_to_qualified": 31.3,
    "qualified_to_converted": 17.3
  },
  "overall_conversion_rate": 1.4
}

---

Industry Overview & Tracked Keywords

Other endpoints in this router worth knowing about (smaller, won't get full sections):

Endpoint	Purpose
GET /v1/intelligence/overview	Top-level dashboard rollup — all industries, total domains, recent growth.
GET /v1/intelligence/industry/{industry}	Lighter version of the report endpoint — JSON only, no PDF.
GET /v1/intelligence/tracked-keywords	List + CRUD on keywords the system watches across all domain summaries.
POST /v1/intelligence/tracked-keywords	Add a keyword.
GET /v1/intelligence/tracked-keywords/summary	Match counts across watched keywords.
GET /v1/intelligence/tracked-keywords/{id}/stats	Detail for a single keyword.

---

Notes

• All intelligence endpoints query the live PostgreSQL domain pool. They reflect data as of the last enrichment cycle (typically < 1 hour stale for top industries, longer for the long tail).
• Geo data sources from registrant_country first, falling back to ip_country when registrant data is missing.
• PDF reports ship with a CronDB-branded cover page. White-labelled PDFs are an Enterprise add-on — contact sales.
• The competitor digest is sent as an email weekly; the API endpoint exposes the same payload for scripted consumption.
• Funnel trends lookback is fixed at 12 weeks. For longer history, query List Funnel per list and aggregate yourself.

Next Steps

• Lead Lists → Funnel — per-list funnel breakdown.
• Search Domains — drill into specific domains an industry report surfaces.
• Watchlist — competitor tracking's lighter cousin (one domain, change history, no industry rollup).