{
  "openapi": "3.0.3",
  "info": {
    "title": "GUESTPOSTLINKS Enterprise Publisher & Guest Post API",
    "description": "Public REST API for searching 1,395+ verified publisher blogs, querying SEO metrics (Moz DA, Ahrefs DR, organic traffic), and retrieving blogger outreach packages.",
    "version": "2.0.0",
    "contact": {
      "name": "GUESTPOSTLINKS Support",
      "email": "hamza.azzzouzi@gmail.com",
      "url": "https://ailalo.com/contact"
    }
  },
  "servers": [
    {
      "url": "https://ailalo.com/api/v2",
      "description": "Primary Production API Gateway"
    },
    {
      "url": "https://postsguest.org/api/v2",
      "description": "Secondary Regional Gateway"
    }
  ],
  "paths": {
    "/websites": {
      "get": {
        "summary": "Search & Filter 1,395+ Verified Publisher Websites",
        "description": "Returns verified publisher websites with real Moz DA, Ahrefs DR, organic monthly search traffic, niche category, and transparent pricing ($22.50 - $75.00).",
        "operationId": "getWebsites",
        "parameters": [
          {
            "name": "niche",
            "in": "query",
            "description": "Filter by industry vertical (e.g. technology, crypto-web3, business-finance, health-fitness)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_da",
            "in": "query",
            "description": "Minimum Moz Domain Authority (DA) threshold",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "min_dr",
            "in": "query",
            "description": "Minimum Ahrefs Domain Rating (DR) threshold",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "description": "Maximum price in USD",
            "required": false,
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "Domain keyword search term",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Max results to return (default 50, max 200)",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching verified publisher websites returned successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "count": { "type": "integer" },
                    "total": { "type": "integer" },
                    "websites": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": { "type": "string" },
                          "domain": { "type": "string" },
                          "niche": { "type": "string" },
                          "da": { "type": "integer" },
                          "dr": { "type": "integer" },
                          "price": { "type": "number" },
                          "traffic": { "type": "string" },
                          "linkType": { "type": "string" },
                          "tat": { "type": "string" },
                          "url": { "type": "string" }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/niches": {
      "get": {
        "summary": "Get All 22 Industry Niches",
        "description": "Returns the complete list of 22 supported industry verticals with slug, label, and site counts.",
        "operationId": "getNiches",
        "responses": {
          "200": {
            "description": "List of industry categories",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "niches": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": { "type": "string" },
                          "name": { "type": "string" },
                          "count": { "type": "integer" }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/packages": {
      "get": {
        "summary": "Get Curated Link Building Packages",
        "description": "Returns bulk blogger outreach packages (DA 50+, DA 60+, DA 70+, Crypto & Web3, Press Release, Local SEO citations).",
        "operationId": "getPackages",
        "responses": {
          "200": {
            "description": "List of link building packages",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "packages": { "type": "array" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/ai-crawlers": {
      "get": {
        "summary": "AI Crawler Telemetry & Detection Logs",
        "description": "Returns real-time detection telemetry for AI search engine crawlers including Google Gemini, Google-Extended, SearchGPT (OAI-SearchBot), ChatGPT, Perplexity, Claude, Apple Intelligence, Meta AI, DeepSeek, Copilot, and other LLM agents. Requires API authentication.",
        "operationId": "getAiCrawlers",
        "security": [{ "BearerAuth": [] }],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "description": "Number of recent log entries to return (10–200)",
            "required": false,
            "schema": { "type": "integer", "minimum": 10, "maximum": 200, "default": 50 }
          },
          {
            "name": "family",
            "in": "query",
            "description": "Filter logs by AI family: Google, OpenAI, Anthropic, Perplexity, Apple, Meta, Amazon, DeepSeek, etc.",
            "required": false,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "AI crawler telemetry with summary, per-engine breakdown, daily trend, and recent logs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "summary": {
                      "type": "object",
                      "properties": {
                        "total_ai_hits": { "type": "integer" },
                        "by_family": { "type": "object" },
                        "by_engine": { "type": "array" },
                        "top_crawled_uris": { "type": "array" },
                        "daily_trend_30d": { "type": "array" }
                      }
                    },
                    "registered_signatures": { "type": "array" },
                    "recent_logs": { "type": "array" }
                  }
                }
              }
            }
          },
          "401": { "description": "Unauthorized - Valid Bearer Token or API Key required" }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key"
      }
    }
  },
  "externalDocs": {
    "description": "Google Gemini & AI Search Grounding Specification",
    "url": "https://ailalo.com/.well-known/gemini.json"
  }
}