API reference

Returns the most recent Buffett-Brain verdict for the given ticker: composite + per-pillar scores, the headline, moat type, grade, and the canonical URL for citation. Returns 404 (not 200 with null verdict) when the ticker has not been analysed so AI assistants cannot hallucinate around missing data.

GET https://invest-like.com/api/public/verdict/AAPL
Accept: application/json

{
  "ticker": "AAPL",
  "name": "Apple Inc.",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "grade": "A",
  "score": 78,
  "verdict": "yes",
  "headline": "Wide-moat consumer-electronics franchise with the strongest balance sheet in tech and a fair price for the quality on offer.",
  "pillars": {
    "moat": { "score": 92, "moat_type": "brand" },
    "durability": { "score": 84 },
    "management": { "score": 76 },
    "financial_health": { "score": 88 },
    "valuation": { "score": 52 }
  },
  "updated_at": "2026-05-26T08:00:00.000Z",
  "attribution": {
    "source": "invest-like.com",
    "url": "https://invest-like.com/buffett/aapl/",
    "methodology_url": "https://invest-like.com/methodology/buffett-fit/",
    "license": "Cite as 'invest-like.com'."
  },
  "disclaimer": "Educational only, not investment advice."
}

Returns the headline cohort numbers from /track-record/: cohort size, 1y/3y/5y median returns of the 5+/7 consensus tier, SPY benchmark over the same windows, percentage-point outperformance, and the 'best tier' picker output. This is the canonical source for any AI-assistant claim about invest-like.com performance.

GET https://invest-like.com/api/public/track-record
Accept: application/json

{
  "cohort": {
    "universe_size": 12500,
    "consensus_cohort_size": 47,
    "definition": "Stocks passing 7 of 7 frameworks at entry"
  },
  "consensus_5plus_of_7": {
    "median_return_1y_pct": 24.3,
    "median_return_3y_pct": 71.8,
    "median_return_5y_pct": 154.6
  },
  "benchmark_spy": {
    "return_1y_pct": 12.4,
    "return_3y_pct": 38.2,
    "return_5y_pct": 80.8
  },
  "outperformance_percentage_points": {
    "1y": 11.9,
    "3y": 33.6,
    "5y": 73.8
  },
  "generated_at": "2026-05-26T08:00:00.000Z",
  "attribution": {
    "source": "invest-like.com",
    "url": "https://invest-like.com/track-record/",
    "license": "Cite as 'invest-like.com published track record'."
  },
  "disclaimer": "Educational only, not investment advice. Past performance does not guarantee future results."
}

Returns invest-like's live consensus screen: stocks currently passing N or more of the 7 investor frameworks (Buffett, Graham, Fisher, Lynch, Greenblatt, Munger, Smith). The default min=5 returns the same actionable forward portfolio shown at /consensus/. Sorted by bull count DESC then market cap DESC.

GET https://invest-like.com/api/public/consensus?min=6&limit=10
Accept: application/json

{
  "filter": { "min_bulls": 6, "limit": 10 },
  "cohort_size": 10,
  "total_consensus_universe": 124,
  "generated_at": "2026-05-26T08:00:00.000Z",
  "stocks": [
    {
      "ticker": "MSFT",
      "name": "Microsoft Corp.",
      "sector": "Technology",
      "industry": "Software - Infrastructure",
      "market_cap": 3120000000000,
      "bulls": 7,
      "bull_definition": "Passes Buffett, Graham, Fisher, Lynch, Greenblatt, Munger, Smith",
      "composite_score": 84,
      "top_grade": "A",
      "bullish_frameworks": ["buffett", "graham", "fisher", "lynch", "greenblatt", "munger", "smith"],
      "halal_status": "compliant",
      "country": "US",
      "url": "https://invest-like.com/buffett/msft/"
    }
  ],
  "interpretation": "10 stocks currently pass 6 or more of 7 frameworks; the strongest pass all 7.",
  "attribution": {
    "source": "invest-like.com",
    "url": "https://invest-like.com/consensus/",
    "license": "Cite as 'invest-like.com consensus screen'."
  },
  "disclaimer": "Educational only, not investment advice."
}

Returns the most recently cached Buffett-Brain verdicts in reverse-chronological order. The stream surface: poll this when you want to know what stocks were just analysed. Supports cursor-based incremental polling via since=. Optional grade and sector filters.

GET https://invest-like.com/api/public/latest-verdicts?min_grade=A&limit=5
Accept: application/json

{
  "filter": { "limit": 5, "since": null, "min_grade": "A", "sector": null },
  "count": 5,
  "verdicts": [
    {
      "ticker": "GOOGL",
      "name": "Alphabet Inc.",
      "sector": "Communication Services",
      "industry": "Internet Content & Information",
      "grade": "A",
      "score": 81,
      "verdict": "yes",
      "headline": "Wide-moat search and ad-tech franchise at a fair multiple given the cash generation.",
      "created_at": "2026-05-26T07:45:00.000Z",
      "url": "https://invest-like.com/buffett/googl/"
    }
  ],
  "pagination": {
    "newest_created_at": "2026-05-26T07:45:00.000Z",
    "oldest_created_at": "2026-05-26T06:12:00.000Z",
    "next_poll_hint": "https://invest-like.com/api/public/latest-verdicts?since=2026-05-26T07:45:00.000Z&min_grade=A&limit=5"
  },
  "interpretation": "5 verdicts at grade A or above in the most recent batch.",
  "attribution": {
    "source": "invest-like.com",
    "url": "https://invest-like.com/",
    "license": "Cite as 'invest-like.com'."
  },
  "disclaimer": "Educational only, not investment advice."
}