{
  "openapi": "3.1.0",
  "info": {
    "title": "Companies API",
    "version": "1.0.0",
    "summary": "The shared registry of about 550 data, AI and tech companies behind the fru.dev directory sites: name, domain, logo, bio, category, headquarters, founding year, status, ticker and SEC CIK, each with its sources",
    "description": "The shared registry of about 550 data, AI and tech companies behind the fru.dev directory sites: name, domain, logo, bio, category, headquarters, founding year, status, ticker and SEC CIK, each with its sources. Synced every morning at 06:15 UTC; each fru.dev site is read on its own cadence (daily to quarterly). Free to read; please cite \"Companies (companies.fru.dev)\" with a link. Responses are cached at the edge; keep to about 60 requests a minute. Guide: https://companies.fru.dev/agents",
    "contact": {
      "name": "fru.dev",
      "url": "https://fru.dev",
      "email": "fru.dev3@gmail.com"
    }
  },
  "externalDocs": {
    "description": "For AI agents",
    "url": "https://companies.fru.dev/agents"
  },
  "servers": [
    {
      "url": "https://companies.fru.dev"
    }
  ],
  "paths": {
    "/api/companies": {
      "get": {
        "operationId": "list_companies",
        "summary": "Companies in the registry, filtered",
        "description": "Companies in the registry, filtered. Returns companies with slug, name, domain, logo, bio, category, HQ, founded, status, ticker and their fru.dev pages.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Name, domain or exact ticker",
            "schema": {
              "type": "string"
            },
            "example": "snowflake"
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Category, e.g. AI, Data, Cloud, Semiconductors",
            "schema": {
              "type": "string"
            },
            "example": "Data"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "public, private, acquired or defunct",
            "schema": {
              "type": "string",
              "enum": [
                "public",
                "private",
                "acquired",
                "defunct"
              ]
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "HQ country, e.g. United States",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "Only companies with a page on this fru.dev site",
            "schema": {
              "type": "string",
              "enum": [
                "earnings",
                "releases",
                "funding",
                "acquisitions",
                "techconf",
                "regulations",
                "paydays",
                "regions",
                "compliance",
                "free",
                "slas",
                "pricing",
                "yc",
                "incidents",
                "leadersboard",
                "leaders",
                "stories",
                "partnerships",
                "keynotes",
                "trending",
                "titles",
                "papers",
                "blogs",
                "cfp",
                "certifications",
                "training",
                "marketplaces"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "ISO time: only rows changed after it, including rejected ones (for syncing)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 2000 (the syncing sites take the whole list)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2000,
              "default": 2000
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "companies with slug, name, domain, logo, bio, category, HQ, founded, status, ticker and their fru.dev pages",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 1,
                  "total": 1,
                  "generated_at": "2026-09-24T03:31:09.151Z",
                  "sync": {
                    "lastRunAt": "2026-09-23T12:06:48Z",
                    "lastOkAt": "2026-09-23T12:06:48Z",
                    "state": "ok",
                    "linksSeen": 1015,
                    "nextRunAt": "2026-09-24T06:15:00.000Z",
                    "delayed": false
                  },
                  "companies": [
                    {
                      "slug": "snowflake",
                      "name": "Snowflake",
                      "domain": "snowflake.com",
                      "aliases": [
                        "Snowflake Inc."
                      ],
                      "logo_url": "https://img.logo.dev/snowflake.com?token=...&format=png&theme=light&retina=true",
                      "bio": "Snowflake Inc. is an American cloud-based artificial intelligence (AI) data platform company founded in San Mateo, California, and headqu...",
                      "bio_source": "https://en.wikipedia.org/wiki/Snowflake_Inc.",
                      "category": "Data",
                      "subcategories": [
                        "Data platform",
                        "AI platform"
                      ],
                      "hq_city": "Menlo Park",
                      "hq_country": "United States",
                      "hq_source": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=1640147",
                      "founded": 2012,
                      "status": "public"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/companies/{slug}": {
      "get": {
        "operationId": "get_company",
        "summary": "One company by its slug (an old or site-specific key answers with the canonical slug)",
        "description": "One company by its slug (an old or site-specific key answers with the canonical slug). Returns the company, its parent and the companies it owns.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Company slug, e.g. snowflake",
            "schema": {
              "type": "string"
            },
            "example": "snowflake"
          }
        ],
        "responses": {
          "200": {
            "description": "the company, its parent and the companies it owns",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "canonical": "snowflake",
                  "company": {
                    "slug": "snowflake",
                    "name": "Snowflake",
                    "domain": "snowflake.com",
                    "aliases": [
                      "Snowflake Inc."
                    ],
                    "logo_url": "https://img.logo.dev/snowflake.com?token=...&format=png&theme=light&retina=true",
                    "bio": "Snowflake Inc. is an American cloud-based artificial intelligence (AI) data platform company founded in San Mateo, California, and headqu...",
                    "bio_source": "https://en.wikipedia.org/wiki/Snowflake_Inc.",
                    "category": "Data",
                    "subcategories": [
                      "Data platform",
                      "AI platform"
                    ],
                    "hq_city": "Menlo Park",
                    "hq_country": "United States",
                    "hq_source": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=1640147",
                    "founded": 2012,
                    "status": "public"
                  },
                  "parent": null,
                  "children": []
                }
              }
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/api/companies/{slug}/across": {
      "get": {
        "operationId": "company_across_sites",
        "summary": "What every fru.dev site says about one company right now",
        "description": "What every fru.dev site says about one company right now. Returns one snippet per site (next earnings, latest release, last round, latest deal, next conference) and a dated timeline.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Company slug, e.g. snowflake",
            "schema": {
              "type": "string"
            },
            "example": "snowflake"
          }
        ],
        "responses": {
          "200": {
            "description": "one snippet per site (next earnings, latest release, last round, latest deal, next conference) and a dated timeline",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "snippets": [
                    {
                      "site": "acquisitions",
                      "url": "https://acquisitions.fru.dev/company/snowflake",
                      "title": "Bought Natoma",
                      "detail": "May 27, 2026 · $110M · 16 deals",
                      "date": "2026-05-27"
                    },
                    {
                      "site": "earnings",
                      "url": "https://quarterly.fru.dev/companies/snowflake",
                      "title": "Next earnings Dec 2, 2026",
                      "detail": "Q3 FY27 · Estimated",
                      "date": "2026-12-02"
                    }
                  ],
                  "timeline": [
                    {
                      "site": "earnings",
                      "date": "2026-12-02",
                      "title": "Q3 FY27 earnings",
                      "url": "https://quarterly.fru.dev/companies/snowflake"
                    },
                    {
                      "site": "techconf",
                      "date": "2026-09-29",
                      "title": "Snowflake World Tour Berlin 2026",
                      "url": "https://techconf.fru.dev/hosts/snowflake"
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/api/companies/{slug}/events": {
      "get": {
        "operationId": "company_events",
        "summary": "One company's history across the fru.dev sites, newest first",
        "description": "One company's history across the fru.dev sites, newest first. Returns dated events (funding rounds, acquisitions, releases, earnings, incidents, price changes, partnerships, keynotes, leadership moves, certifications) with the site, kind, title, value and a link; paged with total and next.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Company slug, e.g. snowflake",
            "schema": {
              "type": "string"
            },
            "example": "snowflake"
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "Only events from this fru.dev site",
            "schema": {
              "type": "string",
              "enum": [
                "earnings",
                "releases",
                "funding",
                "acquisitions",
                "techconf",
                "regulations",
                "paydays",
                "regions",
                "compliance",
                "free",
                "slas",
                "pricing",
                "yc",
                "incidents",
                "leadersboard",
                "leaders",
                "stories",
                "partnerships",
                "keynotes",
                "trending",
                "titles",
                "papers",
                "blogs",
                "cfp",
                "certifications",
                "training",
                "marketplaces"
              ]
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "Only this kind, e.g. funding_round, acquisition, acquired, release, earnings, incident, price_change, partnership, keynote, leader_move, cert",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Events per page, 1 to 100",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Events to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "dated events (funding rounds, acquisitions, releases, earnings, incidents, price changes, partnerships, keynotes, leadership moves, certifications) with the site, kind, title, value and a link; paged with total and next",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "slug": "snowflake",
                  "total": 130,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/companies/snowflake/events?limit=3&offset=3",
                  "events": [
                    {
                      "date": "2027-06-07",
                      "site": "techconf",
                      "site_name": "Events",
                      "kind": "conference",
                      "title": "Snowflake Summit 2027",
                      "value": "San Francisco",
                      "url": "https://events.fru.dev/events/snowflake-summit-2027",
                      "first_seen_at": "2026-09-24T10:18:41Z"
                    },
                    {
                      "date": "2026-11-03",
                      "site": "techconf",
                      "site_name": "Events",
                      "kind": "conference",
                      "title": "Snowflake Expedition 2026",
                      "value": "Online",
                      "url": "https://events.fru.dev/events/snowflake-expedition-2026",
                      "first_seen_at": "2026-09-24T10:18:41Z"
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/api/resolve": {
      "get": {
        "operationId": "resolve_company",
        "summary": "The canonical slug for a domain, a name or a site key",
        "description": "The canonical slug for a domain, a name or a site key. Returns the matching company, or 404.",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": false,
            "description": "Website domain, e.g. snowflake.com",
            "schema": {
              "type": "string"
            },
            "example": "snowflake.com"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "description": "Company name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "With key: the fru.dev site the key comes from",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "key",
            "in": "query",
            "required": false,
            "description": "A site's own company key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "the matching company, or 404",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "slug": "snowflake",
                  "name": "Snowflake",
                  "domain": "snowflake.com",
                  "logo_url": "https://img.logo.dev/snowflake.com?token=...&format=png&theme=light&retina=true",
                  "review": "published",
                  "match": "domain"
                }
              }
            }
          }
        }
      }
    },
    "/api/search": {
      "get": {
        "operationId": "search",
        "summary": "Search companies and pages",
        "description": "Search companies and pages. Returns up to 20 ranked results with title, link and one line.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Company name, ticker or words",
            "schema": {
              "type": "string"
            },
            "example": "nvda"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results, 1 to 20",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "up to 20 ranked results with title, link and one line",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "q": "nvda",
                  "results": [
                    {
                      "id": "co:nvidia",
                      "group": "companies",
                      "title": "Nvidia",
                      "subtitle": "NVDA · Semiconductors · United States",
                      "href": "/companies/nvidia",
                      "keywords": [
                        "NVDA",
                        "nvidia.com"
                      ],
                      "logo": "https://img.logo.dev/nvidia.com?token=...&format=png&theme=light&retina=true&size=64&fallback=404",
                      "boost": 8,
                      "score": 1008
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/companies.json": {
      "get": {
        "operationId": "export_companies",
        "summary": "The whole registry in one file",
        "description": "The whole registry in one file. Returns every published company.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "every published company",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "name": "fru.dev company registry",
                  "source": "https://companies.fru.dev",
                  "generated_at": "2026-09-24T03:19:30.665Z",
                  "count": 550,
                  "companies": [
                    {
                      "slug": "8080-labs",
                      "name": "8080 Labs",
                      "domain": null,
                      "aliases": [],
                      "logo_url": "",
                      "bio": "",
                      "bio_source": "",
                      "category": "Data",
                      "subcategories": [
                        "Data & Analytics"
                      ],
                      "hq_city": "",
                      "hq_country": "",
                      "hq_source": "",
                      "founded": null,
                      "status": ""
                    },
                    {
                      "slug": "accelex",
                      "name": "Accelex",
                      "domain": null,
                      "aliases": [],
                      "logo_url": "",
                      "bio": "",
                      "bio_source": "",
                      "category": "Fintech",
                      "subcategories": [
                        "Fintech"
                      ],
                      "hq_city": "",
                      "hq_country": "",
                      "hq_source": "",
                      "founded": null,
                      "status": ""
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}