# ESGPulse

ESGPulse is an AI-powered ESG (Environmental, Social, and Governance) and sustainability intelligence API. It provides structured JSON responses covering CSRD compliance, EU Taxonomy alignment, supply chain due diligence, carbon emissions, ESG framework selection, sector materiality, greenwashing risk, company ESG intelligence, and ESG disclosure guidance.

All endpoints are gated by x402 micropayment (USDC on Base mainnet, eip155:8453). Payment ranges from $0.10 to $0.25 per query.

## Base URL
https://esgpulse.vercel.app

## Authentication
All endpoints require an x402 payment header (PAYMENT-SIGNATURE). Call without the header to receive a 402 response with payment requirements.

## Endpoints

### GET /api/esg/csrd — $0.25
CSRD compliance roadmap for a company. Returns which ESRS standards apply, reporting phase (1-4), first report deadline, double materiality assessment guide, implementation timeline, and estimated effort.

Parameters:
- sector: Industry sector (retail, manufacturing, technology, financial-services, etc.)
- employees: Number of employees (string)
- turnover: Annual turnover in EUR (string, e.g. "250000000")
- jurisdiction: Primary jurisdiction (default: EU)
- listed: Whether publicly listed (boolean, default: true)
- lang: Response language ISO 639-1 (default: en)

Use when: Starting a CSRD compliance project; determining if a company is in scope; identifying mandatory vs. optional ESRS standards.

### GET /api/esg/taxonomy — $0.20
EU Taxonomy Regulation alignment assessment. Evaluates whether an economic activity qualifies as sustainable under the 6 environmental objectives (CCM, CCA, WMR, CE, PPC, BIO).

Parameters:
- activity: Specific economic activity (e.g. "solar energy generation")
- sector: Industry sector (if activity not specified)
- objective: EU Taxonomy objective to assess (all, CCM, CCA, WMR, CE, PPC, BIO; default: all)
- entity_type: corporate | fund | bank (default: corporate)
- lang: Response language

Use when: Assessing SFDR Article 8/9 fund eligibility; calculating Green Asset Ratio; determining green bond eligibility.

### GET /api/esg/supply-chain — $0.20
Supply chain ESG due diligence. Covers CSDDD obligations by company size, high-risk country profiles, forced labor screening (EU Forced Labour Regulation + US UFLPA), human rights risks by sector, and supplier questionnaire templates.

Parameters:
- company: Company name (optional)
- sector: Industry sector
- origin_countries: Comma-separated ISO country codes (e.g. "CN,BD,VN")
- scope: full | human-rights | environment | governance (default: full)
- lang: Response language

Use when: CSDDD compliance planning; supplier screening; ESG procurement policy development.

### GET /api/esg/disclosure — $0.20
ESG disclosure builder. Returns practical disclosure guidance: ESRS data points checklist, GRI content index template, TCFD 4-pillar structure, reporting calendar, and common gaps.

Parameters:
- framework: CSRD | GRI | ISSB | TCFD | CDP | SEC | all (default: CSRD)
- sector: Industry sector for sector-specific data points
- topic: all | climate | water | biodiversity | social | governance (default: all)
- format: guide | checklist | template (default: guide)
- lang: Response language

Use when: Writing a sustainability report; preparing CSRD statement; structuring TCFD disclosure.

### GET /api/esg/framework — $0.15
ESG reporting framework selector. Recommends which frameworks apply (GRI, ISSB/IFRS S1+S2, CSRD/ESRS, TCFD, CDP, SEC climate rule), explains how they interoperate, and sequences implementation.

Parameters:
- company_type: large-public | large-private | sme | financial-institution | asset-manager
- jurisdiction: Regulatory jurisdiction (default: EU)
- sector: Industry sector
- goal: compliance | investor | customer | all (default: compliance)
- lang: Response language

Use when: Starting an ESG reporting program; choosing between competing frameworks; optimizing for multiple audiences.

### GET /api/esg/emissions — $0.15
Carbon and emissions intelligence. Scope 1/2/3 methodology, current carbon market prices (EU ETS, California, voluntary), CBAM tariff implications, SBTi pathway requirements, net zero roadmap.

Parameters:
- entity: Company or entity name (optional)
- sector: Industry sector for benchmarks
- scope: all | scope1 | scope2 | scope3 (default: all)
- goal: measure | reduce | offset | report | comply (default: measure)
- lang: Response language

Use when: Carbon accounting; CBAM compliance; net zero strategy; SBTi target setting.

### GET /api/esg/sector — $0.15
SASB sector materiality analysis. Industry-specific ESG topics, financial vs. impact materiality, what ESG raters weight most for this sector, peer leaders, regulatory hotspots by jurisdiction.

Parameters:
- sector: Industry sector (Technology, Financial Services, Health Care, Energy, Consumer Goods, etc.) [required]
- focus: all | E | S | G | regulatory | financial (default: all)
- lang: Response language

Use when: Double materiality assessment; investor ESG briefing; peer benchmarking.

### GET /api/esg/greenwashing — $0.15
Greenwashing risk detector. Analyzes sustainability claims against EU Green Claims Directive, FTC Green Guides, and UK CMA Green Claims Code. Provides per-claim risk ratings, substantiation needed, enforcement precedents.

Parameters:
- claims: Sustainability claims text to analyze
- company: Company name for controversy research
- jurisdiction: EU | UK | US | AU | global (default: EU)
- lang: Response language

Use when: Reviewing marketing copy; assessing advertising risk; checking campaign ESG claims.

### GET /api/esg/company — $0.15
Company ESG intelligence from public data. CDP scores, SBTi commitment status, Scope 1/2/3 from public reports, ESG controversies, governance structure. Does NOT reproduce proprietary rater scores.

Parameters:
- company: Company name [required]
- focus: all | environment | social | governance | emissions | controversies (default: all)
- lang: Response language

Use when: Investment due diligence; supplier ESG assessment; competitor benchmarking.

### GET /api/esg/score — $0.10
ESG rating methodology explainer. How MSCI, Sustainalytics, ISS, Bloomberg, CDP, and S&P Global construct ESG scores, why scores diverge for the same company, what drives score changes, how to improve.

Parameters:
- company: Company name (optional, for specific intelligence)
- rater: all | MSCI | Sustainalytics | ISS | Bloomberg | CDP | SP (default: all)
- sector: Industry sector for benchmark context
- lang: Response language

Use when: Understanding ESG rating methodology; investor relations ESG strategy; score improvement planning.

## Data Sources
Real-time data via Tavily web search, synthesized with Claude claude-sonnet-4-6. Sources include: company sustainability reports, CDP disclosures, EFRAG guidance, ISSB standards, GRI publications, regulatory texts (CSRD, CSDDD, EU Taxonomy delegated acts), SBTi target dashboard, and current news.

## Global Coverage
EU (CSRD, CSDDD, EU Taxonomy, SFDR, CBAM), United States (SEC climate rule, FTC Green Guides), United Kingdom (UK SDR, SECR, TCFD mandatory), Japan (GX Carbon Market, ISSB), Australia (AASB S1/S2), Canada (OSFI), Singapore (SGX), plus global frameworks (GRI, ISSB, CDP, TCFD, SBTi).

## Part of PulseNetwork
ESGPulse is one of 50+ verticals in PulseNetwork — the x402 intelligence API ecosystem. Explore others at pulsenetwork.vercel.app.