The primary public website for the company or product behind an API — distinct from the developer portal. The website is where the broader audience (buyers, partners, press, candidates) lands; it usually links downstream into the developer portal, documentation, signup, and pricing. Standardizing a pointer to the website lets discovery tools tie an API back to its parent organization without scraping.

Also known as: Home Page, Company Website, Corporate Website, Marketing Site

Example

- type: Website
  url: https://example.com/

Standards

• Schema.org schema.org WebSite
• Schema.org schema.org Organization
• IETF RFC 8288 — Web Linking
• De facto Open Graph Protocol

OpenAPI Expression

• info.contact.url (OpenAPI 3.x) — Often points to the company website when no separate portal exists.

Link Relations

• canonical — HTML Living Standard
• home — IANA Link Relations

Risk & Compliance

Security: The marketing site is typically a separate CMS from the developer portal but often shares brand assets and analytics tags. Treat redirects from the marketing site into authenticated developer surfaces as trust boundaries; phishing pages routinely impersonate the marketing site to harvest credentials.

Suggested Metrics

• website_to_portal_referrals — Visits that originate on the marketing site and land in the developer portal.
• api_page_views — Visits to API/product pages on the marketing site — a top-of-funnel indicator.

Example Implementations

• Stripe — Marketing site at stripe.com is distinct from the developer surface at stripe.com/docs.
• Twilio — www.twilio.com markets the platform; developers move to twilio.com/docs.
• GitHub — github.com hosts both the product and developer-facing surfaces under one domain.

Related Properties

• Portal
• About
• Contact
• Signup

Tags

• Discovery
• Organization
• Landing Pages

All Common Properties