{"openapi":"3.1.0","info":{"title":"GeoScore API","description":"Score any text or URL for AI/Generative-Engine-Optimization (GEO) readability. Returns a 0–100 score, structural metrics (quick answer, FAQ, tables, sources, headings, reading grade), and a list of concrete fixes.","contact":{"name":"GeoScore","url":"https://geoscoreapi.com/"},"license":{"name":"Proprietary"},"version":"1.0.0"},"paths":{"/api/demo":{"post":{"tags":["Analyze"],"summary":"Public demo endpoint — no API key required, text only, 5k char limit","description":"No-auth demo endpoint used by the landing page. Text only, no URL fetching.","operationId":"demo_api_demo_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/analyze":{"post":{"tags":["Analyze"],"summary":"Score content for AI / GEO readability","description":"Submit `text` (raw text, markdown, or HTML) **or** a `url` to fetch.\nReturns a 0–100 GEO score plus structural metrics and improvement fixes.","operationId":"analyze_api_analyze_post","parameters":[{"name":"X-RapidAPI-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Key"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-GeoScore-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Geoscore-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["Health"],"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/keys/create":{"post":{"tags":["API Keys"],"summary":"Generate a new free-tier API key","operationId":"create_api_key_api_keys_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/keys/lookup":{"get":{"tags":["API Keys"],"summary":"Retrieve API key by email (post-checkout self-serve)","operationId":"lookup_api_key_api_keys_lookup_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/keys/usage":{"get":{"tags":["API Keys"],"summary":"Get usage stats for your API key","operationId":"get_usage_api_keys_usage_get","parameters":[{"name":"X-GeoScore-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Geoscore-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/stripe":{"post":{"tags":["Webhooks"],"summary":"Handle Stripe subscription webhook events","description":"Handles Stripe subscription events:\n- customer.subscription.created / updated → upgrade/create API key\n- customer.subscription.deleted → downgrade to free tier","operationId":"stripe_webhook_webhooks_stripe_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/checkout/session":{"post":{"tags":["Checkout"],"summary":"Create Stripe Checkout session","operationId":"create_checkout_session_api_checkout_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AnalyzeRequest":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","description":"Raw text or HTML content to analyze."},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL to fetch and analyze."}},"type":"object","title":"AnalyzeRequest"},"AnalyzeResponse":{"properties":{"geo_score":{"type":"integer","title":"Geo Score"},"word_count":{"type":"integer","title":"Word Count"},"reading_time_mins":{"type":"number","title":"Reading Time Mins"},"reading_grade_level":{"type":"number","title":"Reading Grade Level"},"flesch_reading_ease":{"type":"number","title":"Flesch Reading Ease"},"has_quick_answer":{"type":"boolean","title":"Has Quick Answer"},"has_faq_section":{"type":"boolean","title":"Has Faq Section"},"has_data_tables":{"type":"boolean","title":"Has Data Tables"},"has_sources_section":{"type":"boolean","title":"Has Sources Section"},"has_numbered_lists":{"type":"boolean","title":"Has Numbered Lists"},"has_bullet_lists":{"type":"boolean","title":"Has Bullet Lists"},"heading_count":{"type":"integer","title":"Heading Count"},"question_headings_count":{"type":"integer","title":"Question Headings Count"},"question_headings_pct":{"type":"number","title":"Question Headings Pct"},"fixes":{"items":{"type":"string"},"type":"array","title":"Fixes"},"analyzed_at":{"type":"string","format":"date-time","title":"Analyzed At"}},"type":"object","required":["geo_score","word_count","reading_time_mins","reading_grade_level","flesch_reading_ease","has_quick_answer","has_faq_section","has_data_tables","has_sources_section","has_numbered_lists","has_bullet_lists","heading_count","question_headings_count","question_headings_pct","fixes","analyzed_at"],"title":"AnalyzeResponse"},"CheckoutRequest":{"properties":{"tier":{"type":"string","title":"Tier"},"email":{"type":"string","title":"Email","default":""}},"type":"object","required":["tier"],"title":"CheckoutRequest"},"CreateKeyRequest":{"properties":{"email":{"type":"string","title":"Email","default":""}},"type":"object","title":"CreateKeyRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"database":{"type":"string","title":"Database"}},"type":"object","required":["status","version","database"],"title":"HealthResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}