{"openapi":"3.0.0","info":{"title":"Gibson Truck World API","description":"AI-optimized API for Gibson Truck World.\n\nThis API provides structured, machine-readable data optimized for AI assistants and LLMs.\n\n**Discovery Endpoints:**\n- `/openapi.json` - This OpenAPI specification\n- `/config.json` - API configuration and endpoint list\n- `/ai-plugin.json` - ChatGPT plugin manifest\n- `/.well-known/ai-manifest.json` - Standardized AI manifest\n- `/llms.txt` - LLM-optimized discovery file\n- `/robots.txt` - AI-friendly robots.txt\n- `/sitemap.xml` - XML sitemap for discovery\n\n**Data Endpoints:**\n- `/business` - Business information (address, contact, hours)\n- `/testimonials` - Customer reviews and ratings\n- `/prompts` - Pre-defined Q&A for common questions\n- `/vehicles` - Complete vehicle inventory with specifications and pricing\n- `/vehicles/{vin}` - Individual vehicle details by VIN or stock number\n- `/sitemap-inventory.xml` - Vehicle inventory sitemap\n\nAll data endpoints return Schema.org JSON-LD format for maximum AI compatibility.","version":"1.0.0","contact":{"email":"support@onekeel.ai"}},"servers":[{"url":"https://agent.gibsontruckworld.com/api/v1/gibson-truck-world","description":"Gibson Truck World API"}],"paths":{"/business":{"get":{"operationId":"getBusinessInfo","summary":"Get business information","description":"Returns complete business profile in Schema.org JSON-LD format including name, address, contact information, hours of operation, services, and Google ratings.","responses":{"200":{"description":"Business information in JSON-LD format","content":{"application/ld+json":{"schema":{"type":"object","properties":{"@context":{"type":"string","example":"https://schema.org"},"@type":{"type":"string","example":"LocalBusiness"},"name":{"type":"string"},"description":{"type":"string"},"telephone":{"type":"string"},"email":{"type":"string"},"address":{"type":"object"},"geo":{"type":"object"},"aggregateRating":{"type":"object"},"sameAs":{"type":"array","items":{"type":"string"}}}}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Get AI discovery file","description":"Returns the llms.txt file optimized for LLM consumption. This file contains structured information about the business formatted specifically for AI assistants.","responses":{"200":{"description":"llms.txt content","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms-txt":{"get":{"operationId":"getLlmsTxtAlt","summary":"Get AI discovery file (alternate URL)","description":"Alternate endpoint for llms.txt content.","responses":{"200":{"description":"llms.txt content","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/testimonials":{"get":{"operationId":"getTestimonials","summary":"Get customer testimonials","description":"Returns customer reviews and testimonials in Schema.org JSON-LD format. Includes reviewer name, rating, review text, and date.","responses":{"200":{"description":"Customer testimonials in JSON-LD format","content":{"application/ld+json":{"schema":{"type":"object","properties":{"@context":{"type":"string"},"@type":{"type":"string","example":"ItemList"},"itemListElement":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string","example":"Review"},"author":{"type":"string"},"reviewRating":{"type":"object"},"reviewBody":{"type":"string"}}}}}}}}}}}},"/prompts":{"get":{"operationId":"getPrompts","summary":"Get available prompts","description":"Returns a list of pre-defined prompts and their expected responses for this business. Useful for understanding common questions about the business.","responses":{"200":{"description":"List of prompts","content":{"application/json":{"schema":{"type":"object","properties":{"prompts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"example_response":{"type":"string"}}}}}}}}}}}},"/robots.txt":{"get":{"operationId":"getRobotsTxt","summary":"Get robots.txt","description":"Returns AI-optimized robots.txt that allows access to AI-related endpoints.","responses":{"200":{"description":"robots.txt content","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/config.json":{"get":{"operationId":"getConfig","summary":"Get API configuration","description":"Returns API configuration including all available endpoints, supported formats, and capabilities. Start here to discover what data is available.","responses":{"200":{"description":"API configuration","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"endpoints":{"type":"object","additionalProperties":{"type":"string"}},"supported_formats":{"type":"array","items":{"type":"string"}}}}}}}}}},"/ai-plugin.json":{"get":{"operationId":"getAiPlugin","summary":"Get ChatGPT plugin manifest","description":"Returns the AI plugin manifest for ChatGPT and compatible AI assistants. Describes the API capabilities and authentication requirements.","responses":{"200":{"description":"AI plugin manifest","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"name_for_human":{"type":"string"},"name_for_model":{"type":"string"},"description_for_human":{"type":"string"},"description_for_model":{"type":"string"},"api":{"type":"object"}}}}}}}}},"/sitemap.xml":{"get":{"operationId":"getSitemap","summary":"Get XML sitemap","description":"Returns an XML sitemap of all available API endpoints for AI and search engine discovery.","responses":{"200":{"description":"XML sitemap","content":{"application/xml":{"schema":{"type":"string"}}}}}}},"/.well-known/ai-manifest.json":{"get":{"operationId":"getAiManifest","summary":"Get AI manifest","description":"Returns the standardized AI manifest file describing this API for AI assistants and automated tools. Includes all endpoints, schema types, and contact information.","responses":{"200":{"description":"AI manifest","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"endpoints":{"type":"object"},"schema_types":{"type":"array","items":{"type":"string"}},"last_updated":{"type":"string"},"contact":{"type":"object"}}}}}}}}},"/vehicles":{"get":{"operationId":"getVehicles","summary":"Get vehicle inventory","description":"Returns complete vehicle inventory with detailed specifications, pricing, availability status, and images in Schema.org JSON-LD format.","responses":{"200":{"description":"Vehicle inventory in JSON-LD format","content":{"application/ld+json":{"schema":{"type":"object","properties":{"@context":{"type":"string"},"@type":{"type":"string","example":"ItemList"},"numberOfItems":{"type":"integer"},"itemListElement":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string","example":"Car"},"name":{"type":"string"},"vehicleIdentificationNumber":{"type":"string"},"manufacturer":{"type":"string"},"model":{"type":"string"},"vehicleModelDate":{"type":"string"},"offers":{"type":"object"}}}}}}}}}}}},"/vehicles/{vin}":{"get":{"operationId":"getVehicleByVin","summary":"Get vehicle by VIN or stock number","description":"Returns detailed information for a specific vehicle by its VIN (Vehicle Identification Number) or by its stock number, exactly as shown in the inventory list. A VIN is tried first; a stock number is matched on this dealer only, ignoring letter case.","parameters":[{"name":"vin","in":"path","required":true,"description":"The 17-character VIN, or the stock number, exactly as shown in the inventory list. A label in front such as \"VIN \" or \"stock \" is ignored.","schema":{"type":"string"}}],"responses":{"200":{"description":"Vehicle details in JSON-LD format","content":{"application/ld+json":{"schema":{"type":"object"}}}},"400":{"description":"The value is neither a VIN nor a possible stock number (a stock number has at least one digit; a word such as UNKNOWN is not one). `error` is \"Invalid VIN format\"; `hint` says what to send."},"404":{"description":"Vehicle not found"},"409":{"description":"More than one vehicle has this stock number. The answer lists their VINs (`vins`): ask again with one of them."}}}},"/sitemap-inventory.xml":{"get":{"operationId":"getSitemapInventory","summary":"Get inventory sitemap","description":"Returns an XML sitemap of all vehicles in inventory for AI discovery.","responses":{"200":{"description":"XML sitemap","content":{"application/xml":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}}}}}}