Data Gobblin - API Documentation

Everything you need to start building with real-time public data

Available Endpoints

Base Data

Building Permits

GET

/api/data-building-permits

Query building permit records with filters

Try It

Building Permits Premium

GET

/api/data-building-permits-premium

AI-enriched permits with category, complexity, timeline

Try It

Building Permit Stats

GET

/api/stats-building-permits

Aggregated statistics, free tier

Try It

Search & Analysis

Natural Language Search

GET

/api/search-building-permits?q=...

Natural language search powered by AI

Try It

Compare Cities

GET

/api/compare-cities?cities=Chicago,San Francisco

Side-by-side city comparison

Try It

Trends

GET

/api/trends

Weekly trend detection and alerts

Try It

Predictive Signals

GET

/api/predictive-signals

AI-powered market predictions

Try It

Natural Language Dashboard

GET

/api/nl-dashboard?q=...

Ask questions in plain English

Try It

Custom Report

GET

/api/custom-report?q=...

AI-generated market analysis reports

Try It

Export & Integration

Export Dataset

GET

/api/export-dataset?format=csv

Download full dataset as CSV or JSON

Try It

Widget

GET

/api/widget?city=Chicago

Embeddable data widget for your site

Try It

Widget Embed Code

GET

/api/widget-embed-code?city=Chicago

Get embed code for any city

Try It

Content Generation

Generate eBook

GET

/api/generate-ebook?city=Chicago

AI-generated market report eBook

Try It

Generate Newsletter

GET

/api/generate-newsletter

Weekly digest newsletter content

Try It

Generate Guide

GET

/api/generate-guide?topic=building+permits

Educational guides

Try It

Generate Scripts

GET

/api/generate-scripts?format=youtube

Video/podcast scripts

Try It

Data Alerts

Create Alert

POST

/api/alerts/configure

Set up a data change alert. Get notified via email or webhook when a niche crosses your threshold. Body: {niche, threshold_type, threshold_value, notification_method, webhook_url}

List Alerts

GET

/api/alerts/configure

List all active alerts for your API key

Try It

Delete Alert

DELETE

/api/alerts/configure?id={alert_id}

Deactivate an alert by ID. Only alerts owned by your key can be deleted.

Account

Generate API Key

GET

/api/generate-api-key

Generate your API key

Try It

Pricing

GET

/api/pricing

View pricing tiers

Try It

Alerts Signup

GET

/api/alerts-signup

Subscribe to data alerts

Try It

Query Parameters

Parameter	Type	Description
`city`	string	Filter by exact city name
`permit_type`	string	Filter permit types using partial match
`keyword`	string	Search text in permit descriptions
`date_from`	YYYY-MM-DD	Include permits issued on or after this date
`date_to`	YYYY-MM-DD	Include permits issued on or before this date
`limit`	integer	Number of records to return (max 100)

Example Request

curl "https://datagobblin.com/api/data-building-permits?city=Chicago&limit=5"

Example Response

{
  "success": true,
  "count": 2,
  "data": [
    {
      "permit_number": "100987654",
      "permit_type": "Commercial Renovation",
      "description": "Interior tenant build-out for office space",
      "address": "120 W Madison St",
      "city": "Chicago",
      "state": "IL",
      "status": "Issued",
      "issue_date": "2026-03-05",
      "estimated_cost": "350000"
    },
    {
      "permit_number": "100987655",
      "permit_type": "Residential Addition",
      "description": "Second-floor addition with electrical upgrade",
      "address": "2456 N Leavitt St",
      "city": "Chicago",
      "state": "IL",
      "status": "Issued",
      "issue_date": "2026-03-04",
      "estimated_cost": "145000"
    }
  ]
}

Data Alerts

Get notified when data changes. Set threshold-based alerts checked daily after scraper cycles complete.

Threshold types:

Type	Description	Example
`new_records`	Fires when N+ new records added in 24h	50 new job postings
`percent_change`	Fires when data volume changes by N%+ vs prior day	25% spike in permits
`absolute_change`	Fires when record count difference exceeds N	100+ record swing

Example (create alert):

curl -X POST https://datagobblin.com/api/alerts/configure \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"niche":"building_permits","threshold_type":"new_records","threshold_value":50}'

Pricing

Free (100 calls/day), Starter $19/mo, Pro $49/mo, Business $99/mo, Enterprise $299/mo. See full details on the pricing page.

How Data Gobblin Compares

Data Gobblin focuses on alternative data freshness, consistent schemas, and transparent pricing. Here's how we compare to other data API providers:

Feature	Data Gobblin	Alpha Vantage	SEC-API	CoinGecko
Free tier	100 calls/day, all niches	25 calls/day	10 requests/min	30 calls/min
Data categories	16+ niches (permits, gas, SEC, jobs, rentals, ecommerce, crypto, Reddit, etc.)	Stocks, forex, crypto	SEC filings only	Crypto only
Alt-data coverage	Building permits, restaurant inspections, business licenses, foreclosures, prediction markets	None	None	None
Freshness SLAs	Published per niche (1h–24h)	15-min delayed	Near real-time	1–10 min
AI-powered features	NL search, predictive signals, custom reports, trend detection	None	Full-text search	None
Export formats	JSON + CSV	JSON + CSV	JSON	JSON
Paid plans from	$25/mo	$49.99/mo	$40/mo	$129/mo

Data Gobblin is not a replacement for financial data terminals. It's built for developers and analysts who need structured alternative data — the stuff that's hard to get from traditional APIs.