Skip to main content

Data Provenance

Data Sources & Provenance

Every number on the dashboard traces back to a source. This page catalogs the 17 data feeds powering the PH Oil Intelligence platform — from 10,000+ gas stations to real-time NLP sentiment.

10 Active
3 Simulated
4 Baseline

OpenStreetMap Overpass API

Active

Complete fuel station dataset for the Philippines extracted via Overpass QL. Includes brand, coordinates, and amenity tags for every mapped station.

Type

Gas Stations

Records

10,469

Frequency

Seed (one-time)

License

ODbL

DOE Oil Monitor (Weekly SRP)

Active

Department of Energy suggested retail prices (SRP) for gasoline and diesel. Published weekly by OIMB. Metro Manila baseline.

Type

Pump Prices

Records

Weekly

Frequency

Every Tuesday

License

Philippine Open Data

Reuters Energy RSS

Active

Real-time energy news feed powering the event timeline and NLP sentiment analysis pipeline.

Type

News Events

Records

Live

Frequency

Every 15 min

License

Fair Use

HuggingFace Inference API

Active

Serverless transformer models for headline sentiment classification. Powers the real-time sentiment gauge.

Type

NLP Sentiment

Records

Live

Frequency

On demand

License

Apache 2.0

Philippine Statistics Authority

Simulated

Official Philippine peso exchange rate data used for crude import cost calculations and scenario modeling.

Type

Forex Rates

Records

Daily

Frequency

Simulated

License

Philippine Open Data

Petron Corporation

Baseline

Bataan refinery capacity and operational data. Petron operates the only refinery in the Philippines (180,000 bpd).

Type

Refinery Data

Records

1 facility

Frequency

Static

License

Shell Philippines

Baseline

Import terminal and depot locations across Luzon, Visayas, and Mindanao for Shell/Pilipinas Shell.

Type

Terminal Data

Records

3 facilities

Frequency

Static

License

Phoenix Petroleum

Baseline

Depot and terminal infrastructure for Phoenix Petroleum, the largest independent oil company in the Philippines.

Type

Terminal Data

Records

2 facilities

Frequency

Static

License

Chevron Philippines

Baseline

Caltex-branded import terminal and distribution depot locations across the Philippine archipelago.

Type

Terminal Data

Records

2 facilities

Frequency

Static

License

CARTO Dark Matter

Active

Dark-themed vector basemap tiles used as the WebGL map background. Served via CartoCDN with global edge caching.

Type

Map Tiles

Records

Continuous

Frequency

Live

License

CC BY 3.0

EIA (US Energy Information)

Simulated

International crude oil benchmark prices (Brent and WTI) used as inputs for the scenario planner and price intelligence panels.

Type

Brent/WTI Benchmark

Records

Daily

Frequency

Simulated

License

Public Domain

Bangko Sentral ng Pilipinas

Simulated

Official central bank exchange rate data for PHP/USD conversion in crude import cost modeling.

Type

PHP/USD Exchange

Records

Daily

Frequency

Simulated

License

Philippine Open Data

PhilStar Business RSS

Active

Philippine business news RSS feed. Primary domestic energy news source for the event timeline.

Type

News Events

Records

Live

Frequency

Every 5 min

License

Fair Use

Google News RSS

Active

Aggregated news search for Philippines oil and OPEC topics. Feeds the event timeline with global coverage.

Type

News Events

Records

Live

Frequency

Every 5 min

License

Fair Use

Reddit Public API

Active

Public search API for r/Philippines and r/energy subreddits. Provides crowd-sourced energy discussion signals.

Type

Social Sentiment

Records

Live

Frequency

Every 5 min

License

Reddit API Terms

DOE Licensed Fuel Retail Outlets (LFRO)

Active

Licensed fuel retail outlets with valid Certificate of Compliance. Used for brand classification and operational status baseline.

Type

Station Classification

Records

10,469

Frequency

Weekly

License

Philippine Open Data

DOE Oil Supply/Demand Reports

Active

Weekly supply inventory and days-of-supply data by region. Powers station status assignment for low-supply and out-of-stock classifications.

Type

Supply Monitoring

Records

Reports

Frequency

Weekly

License

Philippine Open Data

Data Freshness Note

Active sources are connected to live APIs and update automatically during dashboard operation.

Simulated sources use realistic synthetic data modeled on official government publications. In a production deployment, these would connect to real-time DOE, BSP, and EIA APIs.

Baseline sources represent static infrastructure data (refinery locations, terminal capacities) that changes infrequently.