# 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 — plus a consumer-facing ethical-sourcing suite (brand checks, coffee, cocoa, cruelty-free cosmetics, conflict minerals, certified commodities) for conscious-consumer and sourcing-agent use cases.

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

## Base URL
https://esgpulse.theaslangroupllc.com

## 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.

## Ethical Sourcing / Conscious Consumer Suite

Consumer/brand-lens checks for shoppers, sourcing teams, and procurement agents — separate from the corporate ESG endpoints above. All ground in open registries and certifier directories rather than proprietary ratings.

### GET /api/esg/source-check — $0.20
General-purpose ethical-sourcing brand check for any company. Returns certifications found (B Corp, Fairtrade, Rainforest Alliance, etc.), controversies/litigation, UK Modern Slavery Statement Registry status, and a transparency verdict.

Parameters:
- brand: Brand or company name [required]
- category: Product category, optional (apparel, electronics, food, beauty, etc.)
- lang: Response language

Use when: Screening any brand or company for ethical-sourcing red flags before a purchase or procurement decision; no dedicated category endpoint fits.

### GET /api/esg/coffee — $0.10
Coffee-specific ethical-sourcing check. Fair-trade/Rainforest Alliance certification, direct-trade and price-transparency evidence (does the roaster publish farm-gate prices?), red flags, and better-sourced roaster alternatives (names only).

Parameters:
- roaster_or_brand: Coffee roaster or brand name [required]
- origin: Coffee origin country/region, optional
- lang: Response language

Use when: Choosing an ethically-sourced coffee roaster; verifying direct-trade claims.

### GET /api/esg/cocoa — $0.15
Chocolate/cocoa child-labor and controversy check. Covers the live Coubaly et al. v. Nestle/Cargill/Barry Callebaut/Mars/Olam/Mondelez/Hershey litigation, certification status, and EU Deforestation Regulation exposure.

Parameters:
- brand: Chocolate or cocoa brand name [required]
- lang: Response language

Use when: Checking a chocolate brand's child-labor litigation exposure or certification status before purchase or listing.

### GET /api/esg/cruelty-free — $0.05
Cosmetics/beauty cruelty-free cross-check across Leaping Bunny (independently verified) and PETA Beauty Without Bunnies (self-attested), plus parent-company-owns-an-animal-testing-brand and China-market-sales caveats.

Parameters:
- brand: Beauty or cosmetics brand name [required]
- lang: Response language

Use when: Verifying a cruelty-free claim before purchase; understanding why certifier answers can conflict.

### GET /api/esg/minerals — $0.10
Conflict-minerals / smelter conformance check. Responsible Minerals Initiative (RMI) conformant-smelter status for tin, tantalum, tungsten, gold, cobalt, lithium, and mica, plus Kimberley Process participant status for diamonds.

Parameters:
- smelter_or_company: Smelter, refiner, or company name [required]
- metal: tin | tantalum | tungsten | gold | cobalt | lithium | mica | diamonds (optional)
- lang: Response language

Use when: Screening an electronics/jewelry supply chain for conflict-minerals risk; checking a diamond's Kimberley Process participant status.

### GET /api/esg/commodity — $0.10
Certified-commodity check for seafood, palm oil, tea, timber, and cotton. Cross-references Seafood Watch/MSC, RSPO, Ethical Tea Partnership, FSC, and Better Cotton.

Parameters:
- product_or_brand: Product or brand name [required]
- commodity: seafood | palm-oil | tea | timber | cotton [required]
- lang: Response language

Use when: Checking whether a seafood, palm-oil, tea, timber, or cotton product carries a recognized sustainability certification.

### GET /api/esg/fashion — $0.15
Fashion/apparel brand ethical-sourcing check across four aspects: labor (UK Modern Slavery Statement Registry, forced-labor flags), environment (EU Deforestation Regulation exposure, pollution controversies), animal welfare (fur-free policy, Responsible Wool/Down Standard), and transparency (Fashion Transparency Index, published supplier lists). Free open-registry sources only — never a paid rating service.

Parameters:
- brand: Fashion or apparel brand name [required]
- aspect: labor | environment | animal | transparency | overall (default: overall)
- lang: Response language

Use when: Screening an apparel brand's labor, environmental, animal-welfare, or transparency record before purchase or sourcing decision.

## 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.