Rewoven API GitHub ↗

REST API for fashion brand sustainability ratings.

Base URL

https://api.rewovenapp.com

All endpoints return JSON. No authentication required. CORS is enabled for all origins.

Try It

Enter an endpoint to test

List Brands

GET /api/brands

Returns a paginated list of all brands with sustainability scores.

Query Parameters

Parameter	Type	Description
`page`	number	Page number (default: 1)
`limit`	number	Results per page (default: 50)
`category`	string	Filter by category (e.g. "Fast Fashion", "Luxury")
`min_score`	number	Minimum overall score (0-100)
`max_score`	number	Maximum overall score (0-100)
`search`	string	Search by brand name
`sort`	string	Sort order: "score_asc", "score_desc", "name_asc", "name_desc"

Example

# Get fast fashion brands scoring under 20
curl "https://api.rewovenapp.com/api/brands?category=Fast+Fashion&max_score=20&limit=3"

{
  "brands": [
    {
      "name": "SHEIN",
      "slug": "shein",
      "overall_score": 8,
      "grade": "F-",
      "environmental_score": 5,
      "labor_score": 8,
      "transparency_score": 5,
      "animal_welfare_score": 14,
      "price_range": "$",
      "country": "China",
      "category": "Fast Fashion",
      "certifications": [],
      "summary": "Ultra-fast fashion model...",
      "website": "https://www.shein.com",
      "rationale": "Rewoven rates SHEIN 8/100 (grade F-)..."
    }
  ],
  "total": 65,
  "page": 1,
  "pages": 22
}

Get Brand

GET /api/brands/{slug}

Get detailed sustainability data for a single brand by its slug.

curl "https://api.rewovenapp.com/api/brands/patagonia"

Search Brands

GET /api/brands/search?q={query}

Search brands by name. Returns matching brands sorted by relevance.

curl "https://api.rewovenapp.com/api/brands/search?q=nike"

Top Brands

GET /api/brands/top?limit={n}

Get the highest-rated sustainable brands.

curl "https://api.rewovenapp.com/api/brands/top?limit=5"

Worst Brands

GET /api/brands/worst?limit={n}

Get the lowest-rated brands.

curl "https://api.rewovenapp.com/api/brands/worst?limit=5"

Compare Brands

GET /api/brands/compare?brands={slug1},{slug2}

Compare two or more brands side by side.

curl "https://api.rewovenapp.com/api/brands/compare?brands=zara,hm,patagonia"

Alternatives

GET /api/brands/{slug}/alternatives

Get more sustainable alternatives for a brand, in the same category and price range.

curl "https://api.rewovenapp.com/api/brands/shein/alternatives"

List Materials

GET /api/materials

Get all fabric materials with environmental impact data including CO2, water usage, and sustainability scores.

curl "https://api.rewovenapp.com/api/materials"

Response Fields

Field	Type	Description
`name`	string	Material name
`co2_kg_per_kg`	number	CO2 emissions per kg of material
`water_liters_per_kg`	number	Water usage per kg
`biodegradable`	boolean	Whether the material is biodegradable
`recyclable`	boolean	Whether the material can be recycled
`sustainability_score`	number	Overall sustainability score (0-100)

Get Material

GET /api/materials/{slug}

Get detailed impact data for a single material.

curl "https://api.rewovenapp.com/api/materials/organic-cotton"

Stats

GET /api/stats

Get overall statistics: total brands, average score, grade distribution, category breakdown, and more.

curl "https://api.rewovenapp.com/api/stats"

Grading Scale

Grade	Score Range	Meaning
`A+`	90-100	Industry leader in sustainability
`A`	80-89	Excellent sustainability practices
`B`	70-79	Good, with room for improvement
`C`	60-69	Average, some initiatives in place
`C-`	50-59	Below average
`D`	40-49	Poor sustainability efforts
`D-`	30-39	Very poor
`E`	20-29	Minimal effort
`F`	10-19	Almost no sustainability
`F-`	0-9	No sustainability effort

Methodology

Each brand's overall_score is the equal-weighted average of four dimensions, each scored 0–100: environmental (materials, emissions, water, waste), labor practices (wages, worker safety, supply-chain standards), transparency (public reporting and traceability), and animal welfare (fur, leather, wool, and down policies).

Scores are assigned from publicly available information — brand sustainability reports, third-party certifications, and reputable news coverage. Every brand response includes a rationale field: a plain-language explanation of how its score was derived, so the reasoning is transparent rather than a black box.

Disclaimer

Ratings are Rewoven's editorial assessments and expressions of opinion, not statements of fact, provided for general informational purposes only. They are based on information available at the time of review and may not reflect a brand's most recent changes. Rewoven is not affiliated with the brands listed. Brand names and trademarks belong to their respective owners. A brand that believes its rating is inaccurate or out of date can request a review at arhan@rewovenapp.com.