REST API v1.0.0 • UNIFIED OPENAPI 3.1 SPEC

Developer API Reference

Seamlessly integrate Adnove AI video generation, property scrapers, and buyer intelligence pipelines into your CRM or property portal. Outputs 720p HD MP4 video preview assets.

OpenAPI 3.1 JSON
API Contract Modernization Notice (v0.9 Retirement)Retired 2026-10-01

Legacy routes /api/v1/campaigns/generate and /api/v1/tasks/{id} return HTTP 410 Gone. All clients must migrate to POST /api/v1/render-video and GET /api/v1/jobs/{job_id}.

العربية (Arabic Docs)

Active Endpoints (v1.0.0)

Legacy Deprecated (HTTP 410)

POST /api/v1/campaigns/generate410 GONE

→ Migrate to POST /api/v1/render-video

GET /api/v1/tasks/{id}410 GONE

→ Migrate to GET /api/v1/jobs/{id}

Authentication Header

Include your API key in the Authorization header as a Bearer token:

Authorization: Bearer YOUR_ADNOVE_API_KEY
POST/api/v1/analyze

Analyze Listing & Marketing Angles

Analyzes a property listing URL (Mubawab, Sarout, Avito) or raw text description to extract features, price per m², target buyer demographics, and high-converting marketing angles.

Auth: Bearer Token (API Key)
Rate Limit: 100 requests / min
curl -X POST "https://adnove.com/api/v1/analyze" \
  -H "Authorization: Bearer YOUR_ADNOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://mubawab.ma/listing/1234","language":"darija"}'
Request Payload Example (application/json)
{
  "url": "https://mubawab.ma/listing/villa-luxury-marrakech-1234",
  "description": "Luxury 5-bedroom villa for sale in Marrakech Palmeraie, private pool and lush tropical garden.",
  "language": "darija",
  "target_audience": "investor"
}
Example Response (HTTP 200 OK)
{
  "ok": true,
  "status": "success",
  "property": {
    "title": "Luxury Villa Marrakech Palmeraie",
    "city": "Marrakech",
    "district": "Palmeraie",
    "price_mad": 4500000,
    "currency": "MAD",
    "features": [
      "5 Master Suites",
      "Private Infinity Pool",
      "Solar Heating",
      "Gated Security"
    ],
    "marketing_angles": [
      "High-yield tourism investment opportunity exceeding 9% annual ROI",
      "Tranquility and prestige of Palmeraie minutes from downtown Marrakech"
    ]
  }
}

HTTP Error Responses & Failure Codes

StatusCodeDescription / Handling Guidance
400BAD_REQUESTInvalid JSON payload or missing required parameters.
401UNAUTHORIZEDMissing or invalid API key in Authorization header. (Provide "Bearer <key>").
403INSUFFICIENT_SCOPEForbidden. Sandbox preview keys possess preview:read and preview:dispatch scopes, and cannot access billing or user-private tenant resources.
403QUOTA_EXCEEDEDMonthly quota exhausted or insufficient permissions.
429RATE_LIMIT_EXCEEDEDRate limit exceeded. Polling too frequently.
500INTERNAL_SERVER_ERRORInternal server error occurred.