CentralIntelAI API

curl -X POST https://www.centralintelai.com/api/v1/intelligence \
  -H "Authorization: Bearer ciai_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://amazon.com/dp/B09XYZ",
    "title": "Sony WH-1000XM5 Headphones",
    "content": "4.6 stars · 12,480 reviews · $279.99 · Ships in 2 days..."
  }'

{
  "platform_type": "ecommerce",
  "summary": "Amazon product page for premium headphones in a competitive category with strong social proof signals.",
  "guidance": [
    {
      "title": "Price history indicates a pending discount",
      "detail": "This SKU drops 15-20% during Prime Day and major sale events. Current price of $279.99 is near its 90-day high.",
      "priority": "high"
    }
  ],
  "risks": [
    {
      "title": "Review recency skew",
      "detail": "12k+ reviews but 40% clustered in 2022 launch window. Recent reviews trend lower. Verify current hardware revision.",
      "severity": "medium"
    }
  ],
  "insights": [...],
  "recommendations": [...],
  "generated_at": "2026-06-05T20:00:00.000Z"
}

Authorization: Bearer ciai_live_your_key_here

X-Api-Key: ciai_live_your_key_here

<script
  src="https://www.centralintelai.com/widget.js"
  data-api-key="ciai_live_your_key_here"
  data-theme="light"
  data-position="bottom-right"
  async
></script>

dependencies:
  http: ^1.2.0

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<Map<String, dynamic>> fetchIntelligence({
  required String url,
  String? title,
  String? content,
}) async {
  final response = await http.post(
    Uri.parse('https://www.centralintelai.com/api/v1/intelligence'),
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer ciai_live_your_key_here',
    },
    body: jsonEncode({
      'url': url,
      if (title != null) 'title': title,
      if (content != null) 'content': content,
    }),
  );

  if (response.statusCode == 200) {
    return jsonDecode(response.body) as Map<String, dynamic>;
  } else {
    throw Exception('Intelligence request failed: ${response.body}');
  }
}

// In your StatefulWidget or with a FutureBuilder:
final intelligence = await fetchIntelligence(
  url: 'https://yourapp.com/product/123',
  title: 'Product Detail Page',
  content: currentPageText, // optional visible text
);

// Access structured data:
final guidance = intelligence['guidance'] as List;
final risks = intelligence['risks'] as List;
final recommendations = intelligence['recommendations'] as List;

import Foundation

struct IntelligenceRequest: Codable {
    let url: String
    var title: String?
    var content: String?
    var platformType: String?

    enum CodingKeys: String, CodingKey {
        case url, title, content
        case platformType = "platform_type"
    }
}

func fetchIntelligence(
    request: IntelligenceRequest,
    completion: @escaping (Result<[String: Any], Error>) -> Void
) {
    guard let endpoint = URL(string: "https://www.centralintelai.com/api/v1/intelligence") else { return }

    var urlRequest = URLRequest(url: endpoint)
    urlRequest.httpMethod = "POST"
    urlRequest.setValue("application/json", forHTTPHeaderField: "Content-Type")
    urlRequest.setValue("Bearer ciai_live_your_key_here", forHTTPHeaderField: "Authorization")
    urlRequest.httpBody = try? JSONEncoder().encode(request)

    URLSession.shared.dataTask(with: urlRequest) { data, response, error in
        if let error = error { completion(.failure(error)); return }
        guard let data = data,
              let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
        else { completion(.failure(URLError(.badServerResponse))); return }
        completion(.success(json))
    }.resume()
}

// Using async/await
func loadIntelligence() async throws -> [String: Any] {
    let request = IntelligenceRequest(
        url: "https://yourapp.com/current-screen",
        title: "Current screen title"
    )
    return try await withCheckedThrowingContinuation { continuation in
        fetchIntelligence(request: request) { result in
            continuation.resume(with: result)
        }
    }
}

{
  "platform_type": "ecommerce | social | saas | content | forum | marketplace | other",
  "summary": "string — 1-2 sentence intelligence overview",
  "guidance": [
    {
      "title": "string",
      "detail": "string — tactical guidance specific to this platform",
      "priority": "high | medium | low"
    }
  ],
  "risks": [
    {
      "title": "string",
      "detail": "string — risk explanation and mitigation",
      "severity": "high | medium | low"
    }
  ],
  "insights": [
    {
      "title": "string",
      "detail": "string — behavioral or strategic insight"
    }
  ],
  "recommendations": [
    {
      "action": "string — specific action to take",
      "rationale": "string — why this matters now"
    }
  ],
  "generated_at": "ISO 8601 timestamp"
}