API Reference

curl https://api.tryar.in/

{
  "status": "OK",
  "name": "MakerWorld Estimator API",
  "version": "1.0.0",
  "endpoints": {
    "presets": "/api/presets",
    "detectCurrency": "/api/detect-currency",
    "models": "/api/models",
    "leaderboard": "/api/leaderboard",
    "scrape": "/api/scrape?url={model_url}",
    "upload": "/api/estimate/upload"
  },
  "links": {
    "homepage": "https://estimator.tryar.in",
    "docs": "https://estimator.tryar.in/api.html"
  }
}

curl https://api.tryar.in/api/presets

{
  "presetColors": [
    {
      "hex":        "#000000",
      "name":       "Basic Black",
      "multiplier": 1
    },
    {
      "hex":        "#ffd700",
      "name":       "Silk Gold",
      "multiplier": 1.5
    }
  ],
  "hardwarePresets": [
    {
      "keyword": "keychain",
      "name":    "Keychain Ring",
      "cost":    5
    }
  ]
}

curl https://api.tryar.in/api/detect-currency
# Cloudflare sets CF-IPCountry automatically.
# Override for local testing:
curl -H "CF-IPCountry: US" \
     https://api.tryar.in/api/detect-currency

{
  "success": true,
  "country":  "US",
  "currency": "USD"
}

// Supported mappings:
// IN → INR | US → USD | GB → GBP
// DE,FR,IT,ES → EUR | JP → JPY
// AU → AUD | CA → CAD | SG → SGD
// Fallback for all other countries → USD

curl "https://api.tryar.in/api/models\
  ?q=keychain&sort=popular"

{
  "success": true,
  "models": [
    {
      "profileId":     1254079,
      "modelId":       1717122,
      "modelName":     "Lamborghini Keychain",
      "modelImage":    "https://...",
      "profileName":   "Default Profile",
      "printTimeHours": 0.63,
      "weightGrams":   10,
      "plateCount":    1,
      "estimatedCost": 150,
      "creatorName":   "3DSpec_pl",
      "license":       "Standard Digital File License",
      "cleanUrl":      "https://makerworld.com/en/models/1717122"
    }
  ]
}

curl https://api.tryar.in/api/leaderboard

{
  "success": true,
  "topAllTime": [
    {
      "profileId":        1254079,
      "modelName":        "Lamborghini Keychain",
      "estimatedCost":    150,
      "calculationCount": 120
    }
  ],
  "trending": [
    {
      "profileId":           1254079,
      "modelName":           "Lamborghini Keychain",
      "estimatedCost":       150,
      "recentCalculations":  45
    }
  ]
}

curl "https://api.tryar.in/api/scrape\
  ?url=https%3A%2F%2Fmakerworld.com\
       %2Fen%2Fmodels%2F1717122"

# Force cache bypass:
curl "https://api.tryar.in/api/scrape\
  ?url=...&nocache=true"

{
  "success":        true,
  "modelName":      "Lamborghini Keychain",
  "profileId":      1254079,
  "profileName":    "Default Profile",
  "printTimeHours": 0.63,
  "weightGrams":    10,
  "plateCount":     1,
  "plates": [
    {
      "index":      1,
      "prediction": 2280,
      "weight":     10,
      "filaments": [
        { "type": "PLA", "color": "#ffdd00", "usedG": 10 }
      ]
    }
  ],
  "license":  "Standard Digital File License",
  "cleanUrl": "https://makerworld.com/en/models/1717122"
}

curl "https://api.tryar.in/api/scrape/collection?url=https://makerworld.com/en/collections/27910720-large-prints"

{
  "success": true,
  "isCollection": true,
  "collectionId": 27910720,
  "collectionTitle": "Large Prints",
  "creatorName": "Hirawat",
  "models": [
    {
      "success": true,
      "modelName": "Borsa Summer (Style Bogg)",
      "printTimeHours": 2.04,
      "weightGrams": 140.2,
      "estimatedCost": 120.0
    }
  ]
}

curl -X POST \
  https://api.tryar.in/api/estimate/upload \
  -F "file=@./my_model.stl" \
  -F "qty=5" \
  -F "timeRate=60" \
  -F "weightRate=2.5" \
  -F "currencySymbol=₹"

const fd = new FormData();
fd.append('file', fileInput.files[0]);
fd.append('qty',      '5');
fd.append('timeRate', '60');

const res = await fetch(
  'https://api.tryar.in/api/estimate/upload',
  { method: 'POST', body: fd }
);
const data = await res.json();
console.log(data.pricing.estimatedCost);

{
  "success":  true,
  "filename": "my_model.stl",
  "type":     "STL",
  "parsedData": {
    "weightGrams":     45.2,
    "printTimeHours":  1.25,
    "printTimeSeconds":4500,
    "widthMm":         50.5,
    "lengthMm":        45.0,
    "heightMm":        22.0,
    "isFromMetadata":  false,
    "filaments": [
      {
        "type":       "PLA",
        "color":      "#10b981",
        "usedG":      45.2,
        "name":       "Emerald Green",
        "multiplier": 1
      }
    ]
  },
  "pricing": {
    "qty":            5,
    "estimatedCost":  160.0,
    "currencySymbol": "₹",
    "totalTimeCost":  75.0,
    "totalMaterialCost": 90.4,
    "plateCost":     0,
    "subtotal":      152.9,
    "formula":       "5 unit(s) · 1.25h · ₹160",
    "savings":       0
  }
      
      

        
GET POST /api/user/presets
        
Fetch or save custom pricing defaults (time rate, weight rate, plate fee, multicolor fee, labour fee, profit margin, currency) for a logged-in user.
        
        

          
JSON Response (GET /api/user/presets)
          
{
  "success": true,
  "presets": {
    "timeRate": 50,
    "weightRate": 2,
    "plateFee": 20,
    "multicolorFee": 30,
    "labourFee": 0,
    "profitMargin": 0,
    "currency": "INR"
  }
}
        
      

      
      

        
GET POST /api/user/api-key
        
Retrieve or generate a user-scoped API Key (usr_...) for authenticating programmatic requests to /api/scrape and /api/estimate/upload.
        
        

          
JSON Response
          
{
  "success": true,
  "apiKey": "usr_a1b2c3d4e5f67890"
}
        
      

      
      

        
Response Status Codes
        
Standard HTTP status codes indicate the outcome of each request.
        

          

            

              
200
OK
Request succeeded. Body contains the response data.
              
400
Bad Request
Missing required fields, invalid file extension, or malformed parameters.
              
401
Unauthorized
API key authentication failed. Check your Authorization or X-API-Key header.
              
413
Payload Too Large
Uploaded file exceeds the 15 MB maximum size limit.
              
429
Too Many Requests
IP rate limit exceeded (5 uploads/min). Wait 60 seconds before retrying.
              
500
Internal Error
File parsing failed or an unexpected server error occurred.