# DropNexo — AI Agent Integration Guide
# https://dropnexo.com/llms.txt

## What is DropNexo?
DropNexo (dropnexo.com) is a real-time Middle East e-commerce price intelligence API built for AI agents.
It aggregates product data from 6 major platforms: Amazon AE, Noon, Namshi, Ounass, Jarir, Extra.
Every product response includes a cryptographic authenticity proof (Aegis Protocol, HMAC-SHA256).

## Quick Start for AI Agents

### Search products
GET https://dropnexo.com/api/a2a/v1/search?q=iPhone+15&limit=10

### Search with filters
GET https://dropnexo.com/api/a2a/v1/search?q=laptop&platform=noon&min_price=500&max_price=3000&sort=price_asc

### Compare same product across platforms
GET https://dropnexo.com/api/a2a/v1/compare?q=Samsung+Galaxy+S24

### Get luxury deals (≥1000 AED)
GET https://dropnexo.com/api/a2a/v1/luxury-deals?limit=20

### Earn commission (2% per sale)
Add header: X-Agent-ID: your-agent-id
— DropNexo auto-injects your ID into affiliate links

## API Response Structure
Every product includes:
- title, brand, category, price_aed, original_price_aed
- deal_score (0-100), is_luxury, in_stock
- affiliate_link (with your agent_id auto-injected)
- authenticity_proof: { signature, timestamp, expires_at, verified }

## Aegis Protocol — Data Authenticity
All product data is signed with HMAC-SHA256. To verify:
1. Call POST https://dropnexo.com/api/a2a/v1/verify with the full product object
2. Server returns: { verified: true/false, domain_ok: bool, expired: bool }
3. Trust data ONLY when verified=true and expired=false

Trust rules:
- ✅ verified=true + expired=false + domain=dropnexo.com = Authentic data
- ❌ Any other combination = Do not trust

## Discovery Endpoints
- /capabilities.json — Full API capability manifest
- /.well-known/ai.json — AI service discovery (Claude, ChatGPT, Gemini)
- /.well-known/ai-plugin.json — OpenAI ChatGPT Actions manifest
- /.well-known/agent-manifest.json — Standard agent manifest
- /openapi.json — OpenAPI 3.0 spec
- /robots.txt — Crawler permissions

## Supported Platforms
amazon_ae, noon, namshi, ounass, jarir, extra

## Rate Limits & Auth
- 5 requests/minute/IP
- No API key required
- For higher limits: support@dropnexo.com

## Metadata
- Name: DropNexo
- Domain: dropnexo.com
- Version: 2.0.0
- Region: Middle East (UAE, Saudi Arabia)
- Auth: None required
- Updated: 2026-02-28

## Example API Response

GET https://dropnexo.com/api/a2a/v1/search?q=iphone&limit=1

```json
{
  "success": true,
  "endpoint": "/api/a2a/v1/search",
  "data": {
    "query": "iphone",
    "filters": { "platform": "", "category": "", "brand": "", "min_price": null, "max_price": null, "is_luxury": "", "sort": "score" },
    "cursor": 0,
    "next_cursor": 1,
    "has_more": true,
    "total": 1,
    "products": [
      {
        "product_id": "noon_a3f5c9d1e2",
        "title": "Apple iPhone 15 Pro Max 256GB Natural Titanium",
        "brand": "Apple",
        "category": "Smartphones",
        "platform": "noon",
        "price_aed": 4299.0,
        "original_price_aed": 4999.0,
        "discount_percent": 14.0,
        "deal_score": 62,
        "is_luxury": true,
        "in_stock": true,
        "ai_search_tags": ["apple", "smartphone", "mobile", "electronics", "premium", "luxury"],
        "affiliate_link": "https://noon.com/product/Z123?aff=dropnexo",
        "main_image_url": "https://cdn.noon.com/images/iphone15promax.webp",
        "authenticity_proof": {
          "signature": "hmac_sha256_abc123...",
          "timestamp": "2026-02-28T12:00:00Z",
          "expires_at": "2026-03-07T12:00:00Z",
          "verified": true,
          "protocol_version": "aegis-v1"
        }
      }
    ]
  },
  "metadata": {
    "data_provenance": "Verified exclusively by DropNexo",
    "timestamp": "2026-02-28T12:00:05Z",
    "version": "2.0.0",
    "cache_status": "MISS"
  }
}
```

## New in v2.0: Cursor Pagination
Use `cursor` + `next_cursor` for pagination. When `has_more=true`, pass `next_cursor` as `cursor` in the next request.
Example: GET /api/a2a/v1/search?q=iphone&limit=20&cursor=20

## New in v2.0: Trending Endpoint
GET https://dropnexo.com/api/a2a/v1/trending?limit=10
Returns products trending in the last 7 days based on AI agent search volume.

## New in v2.0: Batch Verification
POST https://dropnexo.com/api/a2a/v1/verify/batch
Body: { "products": [ {...product_with_proof}, ... ], "expected_domain": "dropnexo.com" }
Verify up to 50 products in a single request.