Drilling Intelligence (Public)

Free public endpoints for programmatic SEO pages and data exploration. No authentication required.

Endpoint Base: /v1/pseo/drilling-intelligence

Authentication: None required (public endpoints)

Rate Limit: 60 requests/minute per IP

Cache: 1 hour TTL

State Coverage

We track well permits from 26 US oil and gas producing states:

Tier 1 - High Volume (Daily Updates)

State	Code	Regulatory Agency	Key Basins
Texas	TX	Railroad Commission (RRC)	Permian (Delaware/Midland), Eagle Ford, Haynesville
Oklahoma	OK	Corporation Commission (OCC)	Anadarko, SCOOP/STACK
New Mexico	NM	Oil Conservation Division (OCD)	Permian (Delaware)
California	CA	CalGEM	San Joaquin, Los Angeles, Ventura
North Dakota	ND	NDIC	Williston/Bakken
Colorado	CO	ECMC	DJ Basin
Louisiana	LA	SONRIS	Haynesville

Tier 2 - Medium Volume (Weekly Updates)

State	Code	Regulatory Agency	Key Basins
Pennsylvania	PA	DEP	Appalachian (Marcellus)
Ohio	OH	ODNR	Utica/Point Pleasant
Wyoming	WY	WOGCC	Powder River, Green River
West Virginia	WV	WVGES	Marcellus
Montana	MT	Board of Oil & Gas	Bakken (Montana portion)
Utah	UT	DOGM	Uinta Basin

Tier 3 - Low Volume (Weekly Updates)

State	Code	Regulatory Agency
Alaska	AK	AOGCC
Arkansas	AR	AOGC
Kansas	KS	KCC
Mississippi	MS	MSOGB
Nebraska	NE	NOGCC
New York	NY	DEC
Michigan	MI	EGLE
Florida	FL	DEP
Indiana	IN	DNR
Tennessee	TN	TDEC
Kentucky	KY	Division of Oil & Gas
Virginia	VA	DMME
Illinois	IL	IDNR
Alabama	AL	AOGB

Endpoints

Method	Endpoint	Description
GET	`/states`	All states summary
GET	`/states/:state`	State permit summary
GET	`/states/:state/full`	Comprehensive state page
GET	`/basins`	All basins summary
GET	`/basins/:basin`	Basin detail
GET	`/operators`	Top operators ranking
GET	`/operators/:operator`	Operator detail
GET	`/frac-focus`	FracFocus summary
GET	`/frac-focus/full`	Comprehensive FracFocus page
GET	`/frac-focus/chemicals`	Top chemicals
GET	`/duc-wells`	DUC well estimates
GET	`/cycle-times/:basin`	Permit-to-spud cycle times

States Summary

List all states with permit counts.

GET /v1/pseo/drilling-intelligence/states

Parameters

Parameter	Type	Default	Description
`days`	integer	30	Lookback period (7-90)

Response

{
  "data": {
    "states": [
      { "state_code": "TX", "state_name": "Texas", "permit_count": 1543 },
      { "state_code": "OK", "state_name": "Oklahoma", "permit_count": 423 },
      { "state_code": "NM", "state_name": "New Mexico", "permit_count": 322 }
    ],
    "period_days": 30,
    "total_permits": 2288
  },
  "meta": {
    "source": "OilPriceAPI Drilling Intelligence",
    "data_type": "states",
    "cache_ttl": 3600,
    "public": true
  }
}

State Detail

Get permit summary for a specific state.

GET /v1/pseo/drilling-intelligence/states/:state

Parameters

Parameter	Type	Required	Description
`state`	string	Yes	Two-letter state code (e.g., `TX`, `OK`)
`days`	integer	No	Lookback period (7-90, default: 30)

Response

{
  "data": {
    "state_code": "TX",
    "state_name": "Texas",
    "period_days": 30,
    "permits_filed": 1543,
    "permits_by_type": {
      "new_drill": 1321,
      "recomplete": 156,
      "reenter": 66
    },
    "permits_by_status": {
      "approved": 1480,
      "pending": 63
    },
    "top_operators": [
      { "operator": "XTO ENERGY", "permit_count": 89 },
      { "operator": "DIAMONDBACK", "permit_count": 76 }
    ],
    "top_formations": [
      { "formation": "WOLFCAMP", "display_name": "Wolfcamp", "permit_count": 412 },
      { "formation": "BONE_SPRING", "display_name": "Bone Spring", "permit_count": 287 }
    ],
    "top_counties": [
      { "county": "Midland", "permit_count": 234 },
      { "county": "Martin", "permit_count": 198 }
    ],
    "cycle_times": {
      "available": true,
      "sample_size": 523,
      "avg_days": 145,
      "median_days": 128,
      "min_days": 14,
      "max_days": 365
    }
  },
  "meta": {...}
}

State Full Page (pSEO)

Comprehensive state page with all available data. Perfect for programmatic SEO pages.

GET /v1/pseo/drilling-intelligence/states/:state/full

Parameters

Parameter	Type	Required	Description
`state`	string	Yes	Two-letter state code

Response Structure

{
  "data": {
    "state_code": "TX",
    "state_name": "Texas",
    "page_title": "Texas Oil & Gas Drilling Permits, Completions & FracFocus Data",

    "overview": {
      "description": "Texas hosts the prolific Permian Basin, the largest oil-producing region in the US...",
      "key_basins": ["Permian (Delaware Basin)", "Permian (Midland Basin)", "Eagle Ford Shale"],
      "production_rank": "1st in US oil/gas production"
    },

    "regulatory_agency": {
      "name": "Railroad Commission of Texas (RRC)",
      "website": "https://www.rrc.texas.gov/",
      "data_portal": "https://mft.rrc.texas.gov/",
      "contact_phone": "512-463-7288",
      "permit_types": ["new_drill", "recomplete", "reenter", "plugback"]
    },

    "geology": {
      "major_basins": ["Permian (Delaware Basin)", "Eagle Ford Shale", "Haynesville Shale"],
      "key_formations": ["WOLFCAMP", "BONE_SPRING", "SPRABERRY", "EAGLE_FORD"],
      "typical_depths_ft": { "min": 5000, "max": 15000, "avg": 9500 },
      "well_types": { "horizontal": 85, "vertical": 15 },
      "geology_notes": "Texas hosts the prolific Permian Basin..."
    },

    "market_context": {
      "us_production_rank": 1,
      "production_share_pct": 43,
      "active_rig_estimate": 280,
      "notable_events": "ExxonMobil acquired Pioneer Natural Resources (Oct 2024)"
    },

    "well_permits": {
      "data_coverage": {
        "earliest_permit_date": "2018-01-15",
        "latest_permit_date": "2026-01-10",
        "total_permits_all_time": 145823,
        "last_successful_scrape": "2026-01-11T20:00:00Z",
        "update_frequency": "daily",
        "update_time": "2:00 PM CT",
        "data_lag_hours": 24
      },
      "summary": {
        "last_7_days": { "permits": 342, "new_drills": 298, "recompletions": 44 },
        "last_30_days": { "permits": 1543, "new_drills": 1321, "recompletions": 222 },
        "last_90_days": { "permits": 4821, "new_drills": 4102, "recompletions": 719 },
        "last_365_days": { "permits": 18234, "new_drills": 15432, "recompletions": 2802 },
        "year_over_year_change": "+12.3%"
      },
      "trend_data": {
        "weekly_permits": [
          { "week": "2026-01-06", "count": 342 },
          { "week": "2025-12-30", "count": 298 }
        ],
        "monthly_permits": [
          { "month": "2026-01", "count": 892 },
          { "month": "2025-12", "count": 1543 }
        ]
      },
      "top_operators": [...],
      "top_formations": [...],
      "top_counties": [...],
      "permits_by_type": {...},
      "permits_by_status": {...},
      "cycle_times": {...}
    },

    "frac_focus": {
      "data_coverage": {
        "earliest_date": "2011-03-01",
        "latest_date": "2026-01-08",
        "total_disclosures": 89234
      },
      "summary": {
        "last_30_days": { "disclosures": 234, "unique_operators": 45, "states": 1 },
        "last_90_days": {...},
        "last_365_days": {...}
      },
      "water_usage": {
        "available": true,
        "total_gallons": 1980000000,
        "average_per_job_gallons": 8500000,
        "largest_job_gallons": 24000000,
        "jobs_over_10m_gallons": 56
      }
    },

    "operator_profiles": [
      {
        "name": "XTO ENERGY",
        "parent_company": "ExxonMobil",
        "headquarters": "Spring, TX",
        "ticker": "XOM",
        "permits_ytd": 423,
        "pct_share": "5.8%",
        "primary_formations": ["WOLFCAMP", "BONE_SPRING"],
        "frac_jobs_ytd": 189,
        "avg_water_per_job": 8500000,
        "notes": "ExxonMobil subsidiary, largest Permian operator"
      }
    ],

    "seo_content": {
      "title": "Texas Oil & Gas Well Permits | Real-Time RRC Data",
      "meta_description": "Track Texas drilling permits from the Railroad Commission in real-time. Updated daily with 145,000+ permits across Permian, Eagle Ford, and Haynesville basins.",
      "keywords": ["texas", "well permits", "rrc", "drilling", "permian", "eagle-ford", "wolfcamp"],
      "schema_org": {
        "@type": "Dataset",
        "name": "Texas Well Permit Data",
        "description": "...",
        "provider": { "@type": "Organization", "name": "OilPriceAPI" },
        "license": "https://oilpriceapi.com/terms"
      }
    },

    "related_states": [
      { "state_code": "NM", "state_name": "New Mexico", "url": "/v1/pseo/drilling-intelligence/states/nm/full" },
      { "state_code": "OK", "state_name": "Oklahoma", "url": "/v1/pseo/drilling-intelligence/states/ok/full" }
    ]
  },
  "meta": {...}
}

FracFocus Summary

Get FracFocus chemical disclosure statistics.

GET /v1/pseo/drilling-intelligence/frac-focus

Parameters

Parameter	Type	Default	Description
`days`	integer	30	Lookback period (7-365)

Response

{
  "data": {
    "period_days": 30,
    "total_disclosures": 1023,
    "by_state": {
      "TX": 456,
      "OK": 234,
      "NM": 198
    },
    "water_usage": {
      "total_gallons": 8700000000,
      "average_gallons_per_job": 8500000,
      "large_jobs_count": 89
    },
    "top_operators": [
      { "operator": "XTO ENERGY", "job_count": 89 },
      { "operator": "CONOCOPHILLIPS", "job_count": 76 }
    ],
    "chemical_stats": {
      "avg_chemicals_per_job": 24.3,
      "max_chemicals_reported": 87
    }
  },
  "meta": {...}
}

FracFocus Full Page (pSEO)

Comprehensive FracFocus page with complete data coverage.

GET /v1/pseo/drilling-intelligence/frac-focus/full

Response Structure

{
  "data": {
    "page_title": "FracFocus Chemical Disclosure Registry - Complete US Data",

    "data_source": {
      "name": "FracFocus Chemical Disclosure Registry",
      "website": "https://fracfocus.org/",
      "data_download": "https://fracfocusdata.org/digitaldownload/fracfocuscsv.zip",
      "mandated_by": "US DOI Bureau of Land Management + 27 State Regulations",
      "update_frequency": "Daily at 1:00 AM EST (source updates Mon-Fri)"
    },

    "data_coverage": {
      "earliest_date": "2011-01-01",
      "latest_date": "2026-01-08",
      "total_disclosures": 298432
    },

    "by_state": {
      "TX": 156234,
      "OK": 45678,
      "NM": 34567
    },

    "summary": {
      "last_7_days": { "disclosures": 234, "unique_operators": 45, "states": 12 },
      "last_30_days": { "disclosures": 1023, "unique_operators": 89, "states": 18 },
      "last_90_days": { "disclosures": 3456, "unique_operators": 112, "states": 22 },
      "last_365_days": { "disclosures": 14523, "unique_operators": 156, "states": 26 }
    },

    "water_usage": {
      "available": true,
      "total_gallons": 2340000000,
      "average_per_job_gallons": 8500000,
      "largest_job_gallons": 24000000,
      "jobs_over_10m_gallons": 234
    },

    "chemical_stats": {
      "available": true,
      "avg_chemicals_per_disclosure": 24.3,
      "unique_cas_numbers": 1234,
      "most_common": [
        { "name": "Water", "count": 298000 },
        { "name": "Hydrochloric Acid", "count": 267000 }
      ]
    },

    "top_states": [
      { "state_code": "TX", "state_name": "Texas", "disclosures": 156234 }
    ],

    "seo_content": {
      "title": "FracFocus Hydraulic Fracturing Chemical Disclosure Data | OilPriceAPI",
      "meta_description": "Access complete FracFocus chemical disclosure data via API. Real-time fracking chemical data, water usage, and operator activity across all US states.",
      "keywords": ["fracfocus", "fracking", "chemicals", "hydraulic-fracturing", "water-usage", "disclosure"]
    }
  },
  "meta": {...}
}

Basin Endpoints

All Basins

GET /v1/pseo/drilling-intelligence/basins

Single Basin

GET /v1/pseo/drilling-intelligence/basins/:basin

Valid Basins: permian, anadarko, eagle_ford, bakken, appalachian, dj, haynesville

Operators

Top Operators Ranking

GET /v1/pseo/drilling-intelligence/operators

Operator Detail

GET /v1/pseo/drilling-intelligence/operators/:operator

DUC Wells

Get Drilled but Uncompleted (DUC) well estimates.

GET /v1/pseo/drilling-intelligence/duc-wells

Cycle Times

Get permit-to-spud cycle time analysis by basin.

GET /v1/pseo/drilling-intelligence/cycle-times/:basin

Use Cases

Building State Pages

Use the /states/:state/full endpoint to build comprehensive state pages:

const stateData = await fetch(
  'https://api.oilpriceapi.com/v1/pseo/drilling-intelligence/states/tx/full'
).then(r => r.json());

// Access all data for page building
const { overview, regulatory_agency, well_permits, frac_focus, operator_profiles } = stateData.data;

// Build page with comprehensive data
document.querySelector('.permits-count').textContent =
  well_permits.data_coverage.total_permits_all_time.toLocaleString();

SEO Implementation

The endpoints include schema.org structured data:

<script type="application/ld+json">
  ${JSON.stringify(stateData.data.seo_content.schema_org)}
</script>

Monitoring Industry Activity

Track operator activity across states:

import requests

states = ['TX', 'OK', 'NM', 'CO', 'ND']
for state in states:
    data = requests.get(
        f'https://api.oilpriceapi.com/v1/pseo/drilling-intelligence/states/{state}/full'
    ).json()

    yoy = data['data']['well_permits']['summary']['year_over_year_change']
    print(f"{state}: {yoy} YoY")

Well Permits API - Full API access (authentication required)
Rig Counts - Baker Hughes weekly data
Drilling Productivity - EIA DPR data
Forecasts - EIA STEO production outlook