{"openapi":"3.1.0","info":{"title":"topmarketing.lol API","version":"1.0.0","description":"Public, read-only access to Marketing Readiness Scores. No API key. Reports are generated by scanning public websites against objective checks; scan new sites for free on the website.","contact":{"email":"hello@topmarketing.lol"}},"servers":[{"url":"https://topmarketing.lol/api/v1"}],"paths":{"/report":{"get":{"operationId":"getReport","summary":"Latest stored report for a host","description":"Returns the most recent completed scan for the given host: overall score, letter grade, agent-readiness score, leaderboard rank, and every check with its status and points. Evidence for failing checks is included once the full report for that host has been purchased on the site.","parameters":[{"name":"host","in":"query","required":true,"schema":{"type":"string"},"description":"Bare hostname, e.g. example.com"}],"responses":{"200":{"description":"The report","content":{"application/json":{"schema":{"type":"object","required":["host","score","grade","rank","checks"],"properties":{"host":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"score":{"type":"integer","minimum":0,"maximum":100},"grade":{"type":"string","enum":["A","B","C","D","F"]},"agentScore":{"type":["integer","null"]},"rank":{"type":"integer"},"of":{"type":"integer"},"average":{"type":"integer"},"scannedAt":{"type":["string","null"],"format":"date-time"},"reportUrl":{"type":"string"},"checks":{"type":"array","items":{"type":"object","required":["id","group","label","status","score","maxScore"],"properties":{"id":{"type":"string"},"group":{"type":"string"},"label":{"type":"string"},"status":{"type":"string","enum":["pass","partial","fail","na"]},"score":{"type":"integer"},"maxScore":{"type":"integer"},"evidence":{"type":"string"}}}}}}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"}}}}},"components":{"responses":{"Problem":{"description":"RFC 9457 problem details","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}}}}}}}}}