{"name":"SocialShot AI Public API","version":"v1","platform_version":"0.7.0","description":"Public, unauthenticated discovery API for SocialShot AI — an AI fashion content platform that turns a single product photo into studio-grade on-model imagery, marketplace-compliant listing images, Meta/Instagram ad creatives and social campaigns.","documentation":"https://socialshot.ai/developers","openapi":"https://socialshot.ai/openapi.json","api_catalog":"https://socialshot.ai/.well-known/api-catalog","llms_txt":"https://socialshot.ai/llms.txt","endpoints":[{"method":"GET","path":"/api/v1","url":"https://socialshot.ai/api/v1","auth":"none","description":"This document."},{"method":"GET","path":"/api/v1/status","url":"https://socialshot.ai/api/v1/status","auth":"none","description":"Service status and version."},{"method":"GET","path":"/api/v1/tools","url":"https://socialshot.ai/api/v1/tools","auth":"none","description":"Capability catalogue: what each tool does, its inputs and outputs, and the public page documenting it."},{"method":"GET","path":"/api/v1/plans","url":"https://socialshot.ai/api/v1/plans","auth":"none","description":"Plans, prices and credit allowances."}],"platform_api":{"base_url":"https://api.socialshot.ai","openapi":"https://api.socialshot.ai/openapi.json","interactive_docs":"https://api.socialshot.ai/docs","auth":"Bearer token from a signed-in Clerk session (OAuth2 bearer).","public_endpoints":[{"method":"GET","url":"https://api.socialshot.ai/api/health","description":"Platform health and provider capability flags."},{"method":"GET","url":"https://api.socialshot.ai/api/marketplaces","description":"Per-marketplace image specs (required pixel dimensions, background and framing rules) for Amazon, Flipkart, Myntra, Meesho, Ajio and Nykaa."},{"method":"GET","url":"https://api.socialshot.ai/api/legal/documents","description":"Published legal documents and their versions."}],"note":"Generation endpoints require a signed-in user session. Programmatic API keys are not yet issued — see the developer portal."},"versioning":{"scheme":"url-path","current":"v1","stability":"Additive changes (new fields, new endpoints, new enum members) can ship at any time without a version bump. Clients MUST ignore unknown fields.","breaking":"Removing or renaming a field, changing a field's type, or changing the meaning of an existing value requires a new major version at a new URL path (/api/v2/...). /api/v1 keeps working while it is supported.","signals":"A deprecated endpoint returns the Deprecation and Sunset response headers (RFC 9745 / RFC 8594) plus a Link header with rel=\"deprecation\" pointing at the migration notes. Deprecation carries the date the deprecation was announced; Sunset carries the date the endpoint stops responding.","noticePeriod":"At least 180 days between the Deprecation header first appearing and the Sunset date."},"rate_limits":{"policy":"public","quota":120,"window_seconds":60,"scope":"per client IP","headers":["RateLimit-Policy","RateLimit","RateLimit-Limit","RateLimit-Remaining","RateLimit-Reset","Retry-After (on 429)"],"documentation":"https://socialshot.ai/developers#rate-limits"},"content_negotiation":{"description":"Every public HTML page also has a markdown representation, for agents that would rather not spend context on the DOM.","how":["Send `Accept: text/markdown` to any public page URL.","Or append `.md` to the path (e.g. /pricing.md)."],"compliance":"https://acceptmarkdown.com"},"when_to_use":["A user has a plain product or garment photo and needs studio-quality on-model or flat-lay imagery from it, without booking a photographer.","A user needs listing images that pass a specific marketplace's technical rules (Amazon, Flipkart, Myntra, Meesho, Ajio, Nykaa) rather than just 'nice photos'.","A user needs Meta or Instagram ad creatives in placement-correct aspect ratios (feed, story, carousel) from existing product shots.","A fashion, apparel or accessories brand needs a month of social content (calendar plus the assets) in one pass.","A seller targeting the Indian market wants Indian models and India-marketplace formats in the output.","Cost or turnaround is the binding constraint: single visuals land in about 30 seconds and a month-long campaign is typically same-day."],"when_not_to_use":["Video generation. The UGC, product and cinematic video tools exist but are admin-gated while in development, so they are not reachable self-serve.","Virtual try-on. The widget is documented but the feature flag is off.","Editing or generating imagery of a real, identifiable person without rights to their likeness, or of anyone under 18 — both are refused.","Fully unattended end-to-end generation via API key. Programmatic generation credentials are not yet issued; generation today requires a signed-in session. Read-only discovery endpoints are open (see https://socialshot.ai/developers)."],"not_yet_available":[{"name":"Virtual try-on widget","status":"Feature flag off"},{"name":"UGC / product / cinematic video","status":"Admin-gated, in development"},{"name":"Programmatic API keys","status":"Not yet issued — contact us"}],"contact":{"email":"hello@socialshot.ai","web":"https://socialshot.ai/contact"}}