{"name":"GEO Glass Real ROAS Calculator API","description":"Public endpoint for AI assistants and external tools to estimate Real ROAS from Meta, Google, and TikTok inputs.","method":"POST","endpoint":"/api/real-roas/calculate","contentType":"application/json","exampleRequest":{"locale":"es","industry":"beauty_cosmetics","iosMix":"mid","ticket":"mid","funnel":"mixed","platforms":{"meta":{"enabled":true,"spend":8000,"reportedRoas":4.5},"google":{"enabled":true,"spend":6000,"reportedRoas":5.2},"tiktok":{"enabled":true,"spend":3000,"reportedRoas":2.9}},"googleSplit":{"branded_search":30,"non_branded_search":25,"shopping":20,"pmax":20,"youtube":5,"display":0},"tiktok":{"sparkUsage":"mixed","bidding":"conversion"}},"exampleResponse":{"version":"realroas-multiplier-model-v2-google-blended","locale":"es","inputs":{"industry":"beauty_cosmetics","iosMix":"mid","ticket":"mid","funnel":"mixed","googleSplit":{"branded_search":0.3,"non_branded_search":0.25,"shopping":0.2,"pmax":0.2,"youtube":0.05,"display":0},"tiktok":{"sparkUsage":"mixed","bidding":"conversion"},"platforms":{"meta":{"enabled":true,"spend":8000,"reportedRoas":4.5},"google":{"enabled":true,"spend":6000,"reportedRoas":5.2},"tiktok":{"enabled":true,"spend":3000,"reportedRoas":2.9}}},"results":{"meta":{"low":1.15,"mid":1.44,"high":1.73,"confidence":"+/-25%"},"google":{"low":1.63,"mid":2.22,"high":2.79,"confidence":"+/-25%","normalizedSplit":{"branded_search":0.3,"non_branded_search":0.25,"shopping":0.2,"pmax":0.2,"youtube":0.05,"display":0}},"tiktok":{"low":0.98,"mid":1.17,"high":1.36,"confidence":"+/-35%"},"blended":{"reportedAggregateRoas":4.46,"blendedRoas":{"low":0.58,"mid":0.92,"high":1.33},"totalSpend":17000,"totalReportedRevenue":75900,"realRevenueMid":15593,"phantomRevenueMid":60308,"platformCount":3,"confidence":"+/-30%","status":"orange"}},"explanations":{"reportedRoas":"El ROAS que muestra la plataforma publicitaria antes de ajustar inflacion de atribucion.","realRoas":"ROAS estimado despues de aplicar descuentos por plataforma, industria, funnel, iOS, ticket y mix de canales.","blendedRoas":"Estimado cross-platform despues de reducir overlap cuando varias plataformas reclaman el mismo journey.","phantomRevenue":"Revenue reclamado por plataformas que no entra en el estimado blended de punto medio.","googleSplit":"Como se distribuye Google entre branded Search, non-branded Search, Shopping, PMax, YouTube y Display.","confidence":"Rango aproximado de incertidumbre. Mas overlap o mixes opacos aumentan la incertidumbre."},"disclaimer":"Usa esto como estimado de planeacion. No reemplaza holdouts, medicion incremental, media mix modeling o atribucion first-party limpia."},"notes":["Use platform spend and reportedRoas from the user. If exact values are missing, ask for them before calculating.","Google split can be sent as percentages from 0-100 or shares from 0-1.","The result is a planning estimate, not incrementality proof."]}