36 lines (22 loc) · 1020 Bytes

API Reference

Base URL for local development: http://localhost:8000

`GET /health`

Returns service status.

`POST /api/analyze`

Content type: multipart/form-data

Fields:

landing_page_url: required URL string.
ad_copy: optional ad copy string.
ad_image: optional image upload.

At least one of ad_copy or ad_image is required.

Response:

metadata: run details, model name, scrape duration, warnings.
ad: offer, persona, CTA, tone, urgency, trust signals, social proof, objections.
landing_page: hero, CTA, benefits, features, pricing, testimonials, FAQ, trust badges, proof.
comparison: match score, confidence score, mismatches, aligned elements.
recommendations: prioritized recommendations with evidence, impact, confidence, effort, priority.
report: executive summary, findings, actions, narrative.

`POST /api/reports/pdf`

Content type: application/json

Body: an AnalysisResponse returned by /api/analyze.

Response: application/pdf attachment.