🔧 API Reference

Developer API Reference

Integrate AI Mode optimization directly into your applications with our comprehensive API. Build powerful AI search solutions with our developer-friendly tools.

GETTING STARTED

Quick Start Guide

Get up and running with the AI Mode Hub API in minutes.

Authentication

All API requests require authentication using your API key. Include your key in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.aimodehub.com/v1/analyze

Get your API key from your dashboard.

Base URL

All API endpoints are relative to the base URL:

https://api.aimodehub.com/v1

All requests must be made over HTTPS. HTTP requests will be rejected.

API ENDPOINTS

Available Endpoints

Comprehensive API endpoints for AI Mode optimization and analysis.

Content Analysis

Analyze content for AI Mode optimization opportunities.

POST

Endpoint

POST /v1/analyze

Request Body

{
  "url": "https://example.com/page",
  "content": "Your content text here...",
  "options": {
    "include_schema": true,
    "analyze_structure": true
  }
}

Response

{
  "score": 85,
  "recommendations": [
    {
      "type": "schema",
      "priority": "high",
      "description": "Add FAQ schema markup"
    }
  ],
  "ai_visibility": {
    "current": 65,
    "potential": 90
  }
}

Citation Tracking

Track when your content appears in AI Mode responses.

GET

Endpoint

GET /v1/citations?domain=example.com.=30d

Response

{
  "citations": [
    {
      "query": "AI search optimization",
      "cited_url": "https://example.com/guide",
      "timestamp": "2024-12-15T10:30:00Z",
      "position": 1
    }
  ],
  "total_citations": 45,
  "visibility_score": 78
}
SDKs & LIBRARIES

Official SDKs

Use our official SDKs to integrate AI Mode optimization into your preferred programming language.

JavaScript

Official JavaScript SDK for Node.js and browser environments.

View Docs →

Python

Python SDK with async support and comprehensive type hints.

View Docs →

PHP

PHP SDK compatible with modern PHP frameworks and applications.

View Docs →

Ruby

Ruby gem for Rails applications and Ruby scripts.

View Docs →

Need Help?

Our developer support team is here to help you integrate and optimize your AI Mode implementation.