Public API

API reference

Four read-only endpoints exposing the same Buffett-Fit verdicts, track-record numbers, and consensus screen that power the invest-like.com web product. Designed for AI assistants (Custom GPTs, Claude actions, Perplexity actions) and external integrations that want first-party invest-like.com data inline.

Machine-readable spec

OpenAPI 3.1 spec available for Custom GPT Actions

Import the spec URL directly into the OpenAI GPT Builder (Actions tab) to enable the four operations below callable from your Custom GPT. The spec is also consumable by Claude tool-use definitions and Perplexity actions via the same URL.

https://invest-like.com/api/public/openapi.json

Rate limits and attribution

Rate limits

None enforced at this time. The endpoints are CDN-cached so polite use poses no operational risk. If you intend to call more than ~10 requests per second sustained from a single client, please reach out at hello@invest-like.com so we can size the cache appropriately.

Attribution

Required. Every response includes an attribution block with source: "invest-like.com" and a canonical citation URL. When surfacing data in a third-party UI or AI assistant response, cite the source as "invest-like.com" and link the canonical URL from the response. Free for read-only use with attribution.

CORS

All endpoints set Access-Control-Allow-Origin: * so browser-based callers (Custom GPTs, web tooling, AI playgrounds) can fetch directly without a proxy.

Endpoints

Four endpoints, all GET, all JSON. Each section shows the operation ID, params, an example request, and an example response body.

GET/api/public/verdict/{ticker}

getVerdict

Get the cached Buffett-Brain verdict for a ticker

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.

Parameters

Name	Location	Type	Required
`ticker` Stock ticker symbol. Uppercase, 1-16 chars, [A-Z0-9.-] only. Case-insensitive on input.	path	string	yes

Example request

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

Example response

{
  "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."
}

GET/api/public/track-record

getTrackRecord

Get the published track-record headline numbers

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.

Example request

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

Example response

{
  "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."
}

GET/api/public/consensus

getConsensus

Get the live consensus screen (5+ of 7 frameworks)

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.

Parameters

Name	Location	Type	Required
`min` Minimum bull count. Defaults to 5.	query	integer (1 to 7)	no
`limit` Maximum rows returned. Defaults to 30.	query	integer (1 to 100)	no

Example request

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

Example response

{
  "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."
}

GET/api/public/latest-verdicts

getLatestVerdicts

Get the latest Buffett-Brain verdicts (chronological)

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.

Parameters

Name	Location	Type	Required
`limit` Maximum rows returned. Defaults to 20.	query	integer (1 to 100)	no
`since` Returns only verdicts with created_at > since. Use pagination.newest_created_at from a previous response as the cursor.	query	ISO-8601 datetime	no
`min_grade` Inclusive minimum letter grade. e.g. min_grade=B returns B, A, A+. Allowed: A+, A, B, C, D.	query	string	no
`sector` GICS sector name (case-sensitive exact match). e.g. Technology, Financials, Healthcare.	query	string	no

Example request

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

Example response

{
  "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."
}

Setting up a Custom GPT

1In the OpenAI GPT Builder, go to the Actions tab and click "Create new action".
2Choose "Import from URL" and paste https://invest-like.com/api/public/openapi.json. The Builder parses the spec and generates the four operations.
3Set Authentication to "None". The API is fully public.
4In your GPT instructions, add: "When a user mentions a stock ticker, call getVerdict and cite the attribution.url from the response." This wires attribution into the GPT's output without needing separate prompt engineering per query.

OpenAPI 3.1 spec (machine-readable) - importable by Custom GPT Actions, Claude tool definitions, and Perplexity actions.
Embed widget - one-iframe drop-in for blogs / Substacks / Notion.
llms.txt - AI-assistant citation index covering every public surface on the site.
Buffett-Fit methodology - the 5-pillar formula behind the verdicts returned by getVerdict.

Educational only. Data returned by these endpoints is educational, not investment advice. Attribution required: cite as "invest-like.com" with a link to the canonical URL from the response.

API reference

Rate limits and attribution

Rate limits

Attribution

CORS

All endpoints set Access-Control-Allow-Origin: * so browser-based callers (Custom GPTs, web tooling, AI playgrounds) can fetch directly without a proxy.

Endpoints

Four endpoints, all GET, all JSON. Each section shows the operation ID, params, an example request, and an example response body.

GET/api/public/verdict/{ticker}

getVerdict

Get the cached Buffett-Brain verdict for a ticker

Parameters

Name	Location	Type	Required
`ticker` Stock ticker symbol. Uppercase, 1-16 chars, [A-Z0-9.-] only. Case-insensitive on input.	path	string	yes

Example request

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

Example response

{
  "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."
}

GET/api/public/track-record

getTrackRecord

Get the published track-record headline numbers

Example request

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

Example response

{
  "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."
}

GET/api/public/consensus

getConsensus

Get the live consensus screen (5+ of 7 frameworks)

Parameters

Name	Location	Type	Required
`min` Minimum bull count. Defaults to 5.	query	integer (1 to 7)	no
`limit` Maximum rows returned. Defaults to 30.	query	integer (1 to 100)	no

Example request

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

Example response

{
  "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."
}

GET/api/public/latest-verdicts

getLatestVerdicts

Get the latest Buffett-Brain verdicts (chronological)

Parameters

Name	Location	Type	Required
`limit` Maximum rows returned. Defaults to 20.	query	integer (1 to 100)	no
`since` Returns only verdicts with created_at > since. Use pagination.newest_created_at from a previous response as the cursor.	query	ISO-8601 datetime	no
`min_grade` Inclusive minimum letter grade. e.g. min_grade=B returns B, A, A+. Allowed: A+, A, B, C, D.	query	string	no
`sector` GICS sector name (case-sensitive exact match). e.g. Technology, Financials, Healthcare.	query	string	no

Example request

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

Example response

{
  "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."
}

Setting up a Custom GPT

1In the OpenAI GPT Builder, go to the Actions tab and click "Create new action".

2Choose "Import from URL" and paste https://invest-like.com/api/public/openapi.json. The Builder parses the spec and generates the four operations.

3Set Authentication to "None". The API is fully public.

4In your GPT instructions, add: "When a user mentions a stock ticker, call getVerdict and cite the attribution.url from the response." This wires attribution into the GPT's output without needing separate prompt engineering per query.

OpenAPI 3.1 spec (machine-readable) - importable by Custom GPT Actions, Claude tool definitions, and Perplexity actions.

Embed widget - one-iframe drop-in for blogs / Substacks / Notion.

llms.txt - AI-assistant citation index covering every public surface on the site.

Buffett-Fit methodology - the 5-pillar formula behind the verdicts returned by getVerdict.

API reference

OpenAPI 3.1 spec available for Custom GPT Actions

Rate limits and attribution

Rate limits

Attribution

CORS

Endpoints

Parameters

Example request

Example response

Example request

Example response

Parameters

Example request

Example response

Parameters

Example request

Example response

Setting up a Custom GPT

Related

API reference

OpenAPI 3.1 spec available for Custom GPT Actions

Rate limits and attribution

Rate limits

Attribution

CORS

Endpoints

Parameters

Example request

Example response

Example request

Example response

Parameters

Example request

Example response

Parameters

Example request

Example response

Setting up a Custom GPT

Related