{"openapi":"3.0.3","info":{"title":"SEOheist.lol API","description":"Free verified listing board for SaaS, tools, and indie products. Sign in, list your product URL, embed the SEOheist badge, and unlock dofollow after verification (14-day queue on the free tier, or instant upgrade). Share tracked /go links for real click stats. Authenticated kingpin endpoints use the API key from your dashboard.","version":"1.0.0"},"servers":[{"url":"https://seoheist.lol"}],"paths":{"/api/v1/listing/{domain}":{"get":{"summary":"Listing status by domain","description":"Returns dofollow/badge status and click counts for a listed domain. Requires kingpin auth.","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","example":"notion.so"}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"Listing found","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"total_clicks":{"type":"integer"},"is_dofollow":{"type":"boolean"},"is_permanent_dofollow":{"type":"boolean"},"badge_verified":{"type":"boolean"},"role":{"type":"string"}}}}}},"401":{"description":"Unauthorized"},"404":{"description":"Domain not found"}}}},"/api/v1/me":{"get":{"summary":"Current operator profile","description":"Returns the authenticated user, badge state, and owned sites.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"Profile","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"},"referral_code":{"type":"string"},"verified":{"type":"boolean"},"badge":{"type":"object","nullable":true},"sites":{"type":"array","items":{"type":"object"}}}}}}},"401":{"description":"Unauthorized"}}}},"/api/presence":{"post":{"summary":"Presence heartbeat","description":"Browser beacon for unique visits + online count (~2 minute window). Sets first-party cookies.","responses":{"200":{"description":"Counts","content":{"application/json":{"schema":{"type":"object","properties":{"visits":{"type":"integer"},"clicks":{"type":"integer"},"online":{"type":"integer"}}}}}}}}},"/feed.xml":{"get":{"summary":"RSS feed of newest live listings","responses":{"200":{"description":"application/rss+xml"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"BearerAuth":{"type":"http","scheme":"bearer"}}}}