{
    "openapi": "3.0.3",
    "info": {
        "title": "Trustburn Search API",
        "version": "1.0",
        "description": "Free, keyless search over Trustburn companies. Returns rating, review count and profile URL."
    },
    "servers": [
        {
            "url": "https://api.trustburn.com"
        }
    ],
    "paths": {
        "/search": {
            "get": {
                "summary": "Search companies by name or domain",
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "maxLength": 80
                        },
                        "description": "Company name or domain"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 25,
                            "default": 10
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Matching companies"
                    }
                }
            }
        },
        "/company": {
            "get": {
                "summary": "Fetch one company by domain, slug or id",
                "parameters": [
                    {
                        "name": "domain",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "slug",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Company"
                    }
                }
            }
        }
    }
}