v1.0.0

AI Entity Spec

The structured data format for representing AI companies in machine-readable form. Designed for agent retrieval, RAG systems, and generative engine optimization.

AI Agent Retrieval & RAG

Generative Engine Optimization

Enterprise Model Grounding

Automated Competitive Analysis

Endpoints

GET

/company/{slug}/agent.json

Full entity profile for a single company.

GET

/company/{slug}/llms.txt

Human/LLM-readable text profile (llms.txt format).

GET

/compare/{slugA}/vs/{slugB}/agent.json

Structured comparison between two companies.

Plan Gating

Response detail varies by the company's plan on Welcome.AI.

Field	Free	Pro
identity	name only	full
summary	tagline	full
solutions	—	full
faq	—	all 5 sections
classification	—	full
competitors	—	top 5 + scores
evidence	—	full
recommendation_guidance	—	full

Schema Fields

Top-Level

schema_version(string)Current: 1.0.0

entity_type(string)Always "ai_company"

generated_at(ISO 8601)When the response was generated

source(string)Always "welcome.ai"

identity

name(string)Canonical company name

slug(string)URL-safe identifier

profile_url(string)Welcome.AI profile URL

website(string)Official company website

logo_url(string)Company logo image URL

headquarters(string)City/region

founded_year(number|null)Year founded

employee_count_range(string)e.g. "51-200"

social_links(object)linkedin, twitter URLs

summary

tagline(string)Short company tagline

description(string)Full company description

agent_brief(string)150-word factual summary for AI citation

faq[]

question(string)Question text

answer(string)Factual answer

section(string)GEO section: discover, educate, evaluate, convert, enable

Example Response

GET /company/exampleai/agent.json

{
  "schema_version": "1.0.0",
  "entity_type": "ai_company",
  "generated_at": "2026-02-24T00:00:00Z",
  "source": "welcome.ai",
  "identity": {
    "name": "ExampleAI",
    "slug": "exampleai",
    "profile_url": "https://welcome.ai/company/exampleai",
    "website": "https://exampleai.com",
    "logo_url": "https://...",
    "headquarters": "San Francisco, CA",
    "founded_year": 2021,
    "employee_count_range": "51-200",
    "social_links": { "linkedin": "...", "twitter": "..." }
  },
  "summary": {
    "tagline": "AI-powered analytics platform",
    "description": "ExampleAI provides...",
    "agent_brief": "ExampleAI is a San Francisco-based..."
  },
  "solutions": [{
    "name": "Analytics Pro",
    "slug": "analytics-pro",
    "url": "https://welcome.ai/solution/analytics-pro",
    "tagline": "Real-time AI analytics",
    "key_features": ["predictive modeling", "anomaly detection"],
    "pricing_model": "subscription",
    "deployment_options": ["cloud", "on-premise"]
  }],
  "faq": [{
    "question": "What is ExampleAI?",
    "answer": "ExampleAI is an AI analytics platform...",
    "section": "discover"
  }],
  "competitors": [{
    "name": "RivalAI",
    "slug": "rivalai",
    "profile_url": "https://welcome.ai/company/rivalai"
  }],
  "links": {
    "profile": "https://welcome.ai/company/exampleai",
    "llms_txt": "https://welcome.ai/company/exampleai/llms.txt",
    "agent_json": "https://welcome.ai/company/exampleai/agent.json",
    "website": "https://exampleai.com"
  },
  "metadata": {
    "plan": "pro",
    "knowledge_last_updated": "2026-02-20T12:00:00Z",
    "data_completeness_score": 85.5
  }
}

Caching

All endpoints return s-maxage=3600, stale-while-revalidate. Data is pre-generated — no AI processing occurs at request time.

Versioning

Uses semantic versioning via schema_version. Breaking changes bump major, additive fields bump minor.

Get your company's agent.json

Every AI company on Welcome.AI has a machine-readable profile. Upgrade to unlock the full structured data response.

Learn More