{"openapi":"3.1.0","info":{"title":"SOSH Demo API","version":"1.0.0","description":"Eight licensed intelligence products over scoped fictional data. Prices are in USD cents."},"components":{"securitySchemes":{"DemoBearerKey":{"type":"http","scheme":"bearer","bearerFormat":"sosh_demo_*"}}},"paths":{"/api/v1/creators/{creatorId}/score":{"get":{"operationId":"score","summary":"SOSH Score","description":"The canonical score and six component contributions.","security":[{"DemoBearerKey":[]}],"parameters":[{"name":"creatorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}},"/api/v1/creators/{creatorId}/value":{"get":{"operationId":"value","summary":"Creator value","description":"Risk-adjusted unit economics and annual social value.","security":[{"DemoBearerKey":[]}],"parameters":[{"name":"creatorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}},"/api/v1/creators/{creatorId}/audience-quality":{"get":{"operationId":"audience-quality","summary":"Audience quality","description":"Audience quality and the six AQS inputs.","security":[{"DemoBearerKey":[]}],"parameters":[{"name":"creatorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}},"/api/v1/creators/{creatorId}/fraud-risk":{"get":{"operationId":"fraud-risk","summary":"Fraud risk","description":"Authenticity, evidence, and value deductions.","security":[{"DemoBearerKey":[]}],"parameters":[{"name":"creatorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}},"/api/v1/campaign-predictions":{"post":{"operationId":"campaign-prediction","summary":"Campaign prediction","description":"Predicted outcomes and confidence for a proposed campaign.","security":[{"DemoBearerKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["creatorId"],"properties":{"creatorId":{"type":"string"},"brandId":{"type":"string"},"postId":{"type":"string"},"objective":{"type":"string","enum":["awareness","conversion","engagement"]},"distribution":{"type":"string","enum":["organic","paid"]},"timing":{"type":"string","enum":["typical","audience-peak","off-peak"]},"paidSpend":{"type":"number","minimum":0,"maximum":10000,"description":"Paid-media USD per post; default 250 for paid distribution. Included in costs."},"format":{"type":"string","enum":["short-video","long-video","story","livestream","static","newsletter"]}}}}}},"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}},"/api/v1/brand-fit":{"post":{"operationId":"brand-fit","summary":"Brand fit","description":"Audience and category fit for a specific brand.","security":[{"DemoBearerKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["creatorId","brandId"],"properties":{"creatorId":{"type":"string"},"brandId":{"type":"string"},"postId":{"type":"string"},"objective":{"type":"string","enum":["awareness","conversion","engagement"]},"distribution":{"type":"string","enum":["organic","paid"]},"timing":{"type":"string","enum":["typical","audience-peak","off-peak"]},"paidSpend":{"type":"number","minimum":0,"maximum":10000,"description":"Paid-media USD per post; default 250 for paid distribution. Included in costs."},"format":{"type":"string","enum":["short-video","long-video","story","livestream","static","newsletter"]}}}}}},"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}},"/api/v1/post-values":{"post":{"operationId":"post-value","summary":"Post value","description":"Explainable post valuation from performance inputs.","security":[{"DemoBearerKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["creatorId"],"properties":{"creatorId":{"type":"string"},"brandId":{"type":"string"},"postId":{"type":"string"},"objective":{"type":"string","enum":["awareness","conversion","engagement"]},"distribution":{"type":"string","enum":["organic","paid"]},"timing":{"type":"string","enum":["typical","audience-peak","off-peak"]},"paidSpend":{"type":"number","minimum":0,"maximum":10000,"description":"Paid-media USD per post; default 250 for paid distribution. Included in costs."},"format":{"type":"string","enum":["short-video","long-video","story","livestream","static","newsletter"]}}}}}},"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}},"/api/v1/creators/{creatorId}/score-history":{"get":{"operationId":"score-history","summary":"Historical score","description":"Reproducible historical score snapshots.","security":[{"DemoBearerKey":[]}],"parameters":[{"name":"creatorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful scoped response"},"401":{"description":"Invalid or revoked key"},"403":{"description":"Insufficient scope"},"404":{"description":"Unavailable record"},"405":{"description":"Method not allowed"},"409":{"description":"State conflict"},"422":{"description":"Invalid input"},"429":{"description":"Rate or quota exhausted"}}}}}}