{"openapi":"3.0.3","info":{"title":"\u0641\u0627\u0644\u0648\u06a9\u062a \u2014 NeuralPress AI API","description":"\u0641\u0627\u0644\u0648\u06a9\u062a\n\nThis site uses NeuralPress AIO to expose AI-readable endpoints. All endpoints are read-only and publicly accessible unless noted otherwise.","version":"3.5.8","contact":{"name":"\u0641\u0627\u0644\u0648\u06a9\u062a","url":"https:\/\/followket.ir","email":"info@followket.ir"},"x-generated-by":"NeuralPress AIO v3.5.8"},"servers":[{"url":"https:\/\/followket.ir\/smm\/neuralpress\/v1","description":"\u0641\u0627\u0644\u0648\u06a9\u062a NeuralPress REST API"}],"tags":[{"name":"content","description":"Content retrieval and LLM-optimized data"},{"name":"verification","description":"Source verification and trust signals"},{"name":"citation","description":"Citation-optimized structured content"},{"name":"discovery","description":"API discovery and schema"}],"paths":{"\/llm-data":{"get":{"tags":["content"],"summary":"Get all published posts in LLM-optimized format","operationId":"getLLMData","parameters":[{"name":"per_page","in":"query","schema":{"type":"integer","default":10},"description":"Results per page"},{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"}],"responses":{"200":{"description":"Array of posts in LLM-ready format","content":{"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/LLMPost"}}}}}}}},"\/llm-data\/{id}":{"get":{"tags":["content"],"summary":"Get a single post by ID in LLM-optimized format","operationId":"getLLMDataById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Post in LLM-ready format","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LLMPost"}}}},"404":{"description":"Post not found"}}}},"\/search":{"get":{"tags":["content"],"summary":"Search site content","operationId":"searchContent","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Search query"},{"name":"limit","in":"query","schema":{"type":"integer","default":5}}],"responses":{"200":{"description":"Search results"}}}},"\/verify":{"get":{"tags":["verification"],"summary":"Verify if a claim originates from this site","description":"AI systems can call this to verify whether a specific claim or phrase genuinely exists in the site's content. Returns confidence score and matching post URLs.","operationId":"verifySource","parameters":[{"name":"claim","in":"query","required":true,"schema":{"type":"string","minLength":5},"description":"The text claim or phrase to verify"},{"name":"max_results","in":"query","schema":{"type":"integer","default":3,"maximum":10}}],"responses":{"200":{"description":"Verification result","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/VerifyResult"}}}},"400":{"description":"Claim too short"}}}},"\/cite\/{id}":{"get":{"tags":["citation"],"summary":"Get citation-optimized structured content for a post","description":"Returns content in Subject\u2192Predicate\u2192Object format, key facts, definitions, and citation metadata. Designed for LLM citation workflows.","operationId":"getCitation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Citation-optimized content","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CitationResult"}}}}}}},"\/openapi.json":{"get":{"tags":["discovery"],"summary":"This OpenAPI specification","operationId":"getOpenAPISpec","responses":{"200":{"description":"OpenAPI 3.0 specification"}}}},"\/verify\/status":{"get":{"tags":["discovery"],"summary":"Get API status and capabilities","operationId":"getAPIStatus","responses":{"200":{"description":"API status information"}}}}},"components":{"schemas":{"LLMPost":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"excerpt":{"type":"string"},"content_text":{"type":"string","description":"Plain text content without HTML"},"author":{"type":"string"},"published_at":{"type":"string","format":"date-time"},"categories":{"type":"array","items":{"type":"string"}}}},"VerifyResult":{"type":"object","properties":{"verified":{"type":"boolean","description":"True if confidence >= 0.5"},"confidence":{"type":"number","format":"float","minimum":0,"maximum":1},"claim":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"excerpt":{"type":"string"},"match_type":{"type":"string","enum":["exact","strong","partial"]},"confidence":{"type":"number"},"published_at":{"type":"string","format":"date-time"}}}},"site":{"type":"string","format":"uri"},"checked_at":{"type":"string","format":"date-time"}}},"CitationResult":{"type":"object","properties":{"post_id":{"type":"integer"},"title":{"type":"string"},"canonical_url":{"type":"string","format":"uri"},"author":{"type":"string"},"published_at":{"type":"string","format":"date-time"},"summary":{"type":"string","description":"2-3 sentence summary"},"key_facts":{"type":"array","items":{"type":"object","properties":{"subject":{"type":"string"},"predicate":{"type":"string"},"object":{"type":"string"}}}},"definitions":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"definition":{"type":"string"}}}},"cite_as":{"type":"string","description":"APA-style citation string"}}}}}}