# AntraAI Intelligence — Complete Technical Specification

> AntraAI Intelligence is an AI-native search intelligence, vanity URL orchestration, AEO/GEO engine, and custom domain infrastructure platform.

## 1. REST API Specification

Base URLs:
- Production API: https://api.antraai.in
- Local Development: http://localhost:5050

Authentication:
- Format: `Authorization: Bearer <JWT_TOKEN>`
- All authenticated endpoints require this header.

### Endpoints

#### POST /api/auth/signup
Registers a new user account.
Body:
```json
{
  "name": "Jane Doe",
  "email": "jane@company.com",
  "password": "SecurePassword123!",
  "workspaceSlug": "acme"
}
```

#### POST /api/auth/login
Authenticates an existing user and returns a signed JWT token.
Body:
```json
{
  "email": "jane@company.com",
  "password": "SecurePassword123!"
}
```

#### POST /api/urls
Creates a new short vanity URL with optional UTM tracking and target device rules.
Body:
```json
{
  "longUrl": "https://company.com/product-launch",
  "customSlug": "launch-2026",
  "domainId": "dom_optional_id",
  "utmSource": "newsletter",
  "utmMedium": "email",
  "utmCampaign": "q4_launch"
}
```

#### GET /api/domains
Lists all custom domains associated with the authenticated account.

#### POST /api/domains
Registers a custom branded domain.
Body:
```json
{
  "domain": "go.brand.com"
}
```

#### GET /api/seo/robots?domain=antraai.in
Fetches and parses the live robots.txt directives for any specified domain.

#### GET /api/seo/crawl-check?domain=antraai.in&path=/&userAgent=Googlebot
Simulates crawler access against robots.txt directives for specific user agents.

#### POST /api/billing/checkout
Initializes a Dodo Payments hosted checkout session with a 7-day free trial.
Body:
```json
{
  "plan": "pro"
}
```

#### POST /api/billing/start-trial
Activates a 7-day trial directly for eligible accounts.
Body:
```json
{
  "plan": "pro"
}
```

## 2. AEO (Answer Engine Optimization) & GEO Guide

AntraAI implements automated AEO/GEO by:
1. Serving machine-readable structured JSON-LD (`SoftwareApplication`, `FAQPage`, `Organization`) with every page response.
2. Exposing `/llms.txt` and `/llms-full.txt` for generative models.
3. Enabling high crawl priority for AI user agents: GPTBot, ChatGPT-User, PerplexityBot, ClaudeBot, Google-Extended, and Applebot-Extended.
4. Injecting geographic metadata (`geo.region`, `geo.placename`, `ICBM`) for local knowledge graph indexing.

## 3. Edge Middleware Routing (Next.js / Cloudflare)

AntraAI delivers zero-latency 302 redirects with cache-control overrides so every click is accounted for:
```typescript
// Header: Cache-Control: no-store, no-cache
// Prevents browser click dropping while passing verified bot crawlers directly
```

## 4. Verification Metadata Supported

- Google Search Console: `<meta name="google-site-verification" content="..." />`
- Bing Webmaster Tools: `<meta name="msvalidate.01" content="..." />`
- Pinterest: `<meta name="p:domain_verify" content="..." />`
- Yandex: `<meta name="yandex-verification" content="..." />`
- Baidu: `<meta name="baidu-site-verification" content="..." />`
- Canonical URLs: `<link rel="canonical" href="..." />`