{"openapi":"3.1.0","info":{"title":"VisibilityAI Global Business Search","description":"Search verified businesses worldwide by category and city. Real data from VisibilityAI's GEO-optimized business directory. Use for queries like 'best accountant in London', 'top lawyers in Dubai', 'dentists in New York'.","version":"1.0.0"},"servers":[{"url":"https://visibilityai.in"}],"paths":{"/api/openai-plugin":{"get":{"operationId":"searchBusinesses","summary":"Search businesses by category and city","description":"Returns verified businesses matching the given category and city worldwide. Use this for any query about finding professionals or businesses globally. Results include contact details, AI descriptions, services, and GEO scores.","parameters":[{"name":"category","in":"query","required":true,"description":"Type of business to find. Examples: CA, Chartered Accountant, Lawyer, Doctor, Dentist, Digital Agency, Software Company, Restaurant, Gym, Real Estate, School, Coaching, Architect, Interior Designer, Financial Advisor, Event Management, Photographer, Hospital","schema":{"type":"string"}},{"name":"city","in":"query","required":true,"description":"City name worldwide. Examples: Mumbai, London, Dubai, New York, Singapore, Sydney, Delhi, Bangalore, Toronto, Hong Kong","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Number of results to return (1-10). Default: 5.","schema":{"type":"integer","default":5,"minimum":1,"maximum":10}}],"responses":{"200":{"description":"Matching businesses found","content":{"application/json":{"schema":{"type":"object","properties":{"businesses":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Business name"},"category":{"type":"string","description":"Business category"},"city":{"type":"string","description":"City"},"state":{"type":"string","description":"State"},"phone":{"type":"string","description":"Contact phone number"},"website":{"type":"string","description":"Website URL"},"description":{"type":"string","description":"AI-generated business description"},"services":{"type":"string","description":"Services offered"},"usp":{"type":"string","description":"Unique selling proposition"},"rating":{"type":"number","description":"Business rating (0-5)"},"geoScore":{"type":"number","description":"GEO Score — AI visibility score 0-100"},"profileUrl":{"type":"string","description":"Full profile URL on VisibilityAI"}}}},"total":{"type":"integer","description":"Number of results returned"},"query":{"type":"object","properties":{"category":{"type":"string"},"city":{"type":"string"}}},"browseUrl":{"type":"string","description":"URL to browse all results on VisibilityAI"}}}}}},"400":{"description":"Missing required parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/v2/entity-profile":{"get":{"operationId":"getEntityProfile","summary":"Full structured entity record for a business","description":"Returns identity, contact, AI signals, services, schema.org JSON-LD, and provenance-tracked claims (property + source + confidence — not a flat unqualified record) for a business. Works without an API key at a reduced rate limit (500/day per IP); an API key raises the limit to 10,000/month and unlocks history=true.","parameters":[{"name":"slug","in":"query","required":true,"description":"Business slug identifier","schema":{"type":"string"}},{"name":"history","in":"query","required":false,"description":"If true and an API key is supplied, returns full claim history including superseded claims.","schema":{"type":"boolean","default":false}}],"security":[{"ApiKeyAuth":[]},{}],"responses":{"200":{"description":"Entity profile"},"404":{"description":"Entity not found"},"410":{"description":"Entity decommissioned (inactive/expired subscription)"},"429":{"description":"Anonymous rate limit exceeded — supply an API key or wait."}}}},"/api/v2/knowledge-graph":{"get":{"operationId":"getKnowledgeGraph","summary":"Real co-citation knowledge graph between businesses","description":"type=network returns a business's real co-mention connections. type=complementary returns categories that genuinely co-occur with a given category+city, derived from actual content (not a hardcoded list). type=top_pairs returns the strongest edges platform-wide. No params returns aggregate graph stats.","parameters":[{"name":"businessId","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["network","complementary","top_pairs"]}}],"security":[{"ApiKeyAuth":[]},{}],"responses":{"200":{"description":"Knowledge graph data"},"429":{"description":"Anonymous rate limit exceeded — supply an API key or wait."}}}},"/business/{slug}/agent.json":{"get":{"operationId":"getAgentProfile","summary":"Get AI-agent-readable profile for a specific business (ABO/1.0)","description":"Returns a structured ABO/1.0 agent profile for a business. AI agents can use this to autonomously read business data, find contact info, get pre-built Q&A intents, and execute actions like calling, navigating, or inquiring on behalf of the user. No authentication required.","parameters":[{"name":"slug","in":"path","required":true,"description":"Business slug identifier (e.g. sharma-associates-ca-mumbai)","schema":{"type":"string"}}],"responses":{"200":{"description":"Agent profile (ABO/1.0 schema)","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","description":"ABO/1.0"},"entity":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"city":{"type":"string"},"description":{"type":"string"},"verified":{"type":"boolean"},"trustScore":{"type":"number"}}},"contact":{"type":"object","properties":{"phone":{"type":"string"},"website":{"type":"string"},"address":{"type":"string"}}},"actions":{"type":"array","description":"Executable actions an AI agent can take on behalf of the user","items":{"type":"object","properties":{"actionId":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["contact","navigate","inquire","schedule","verify"]},"description":{"type":"string"},"href":{"type":"string"}}}},"intents":{"type":"array","description":"Pre-built Q&A intents for common agent queries","items":{"type":"object","properties":{"query":{"type":"string"},"answer":{"type":"string"},"confidence":{"type":"number"}}}},"agentInstructions":{"type":"string"}}}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"vai_live_<key>","description":"API Access key from https://visibilityai.in/developers (₹4,999/month, 10,000 requests/month). Omit for reduced-rate anonymous access."}}}}