MRR Ledger Search.json API
The Search.json API from MRR Ledger — 1 operation(s) for search.json.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mrrledger:mrrledger-search-json-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: MRR Ledger Search.json API
version: 1.0.0
description: Real agentic businesses that make money. Every number sourced.
license:
name: CC BY 4.0
x-rate-limits:
status: live
per_day_utc:
free (no key, per IP): 100
hobby: 2000
builder: 10000
pro: 10000
team (5 keys, shared): 25000
metered:
- /api/v1/search.json
- /api/v1/compare.json
- /mcp (tools/call only)
- /api/v1/export.csv
- /api/v1/export.jsonl
- /api/v1/history.json
unmetered: static /api/v1/*.json and *.csv files
headers:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset
- X-RateLimit-Plan
- Retry-After (on 429)
servers:
- url: https://mrrledger.com
security:
- {}
- ApiKeyHeader: []
- BearerAuth: []
tags:
- name: Search.json
paths:
/api/v1/search.json:
get:
summary: Substring search over businesses (name, slug, one_liner, tags, lessons)
parameters:
- name: q
in: query
required: false
schema:
type: string
description: Substring query (also accepts query=)
- name: category
in: query
required: false
schema:
type: string
- name: tier
in: query
required: false
schema:
type: string
enum:
- venture
- indie
- experiment
- name: verified_only
in: query
required: false
schema:
type: boolean
description: true/1 keeps only businesses whose headline figure is payment-processor verified (headline_verification not null). Self-reported headlines with a verified_corroboration do not qualify.
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
description: Max results per page (default all, max 100)
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
description: Skip this many matches (default 0). Use next_offset from the previous page.
- name: cursor
in: query
required: false
schema:
type: string
description: 'Opaque page token: next_cursor from the previous page of the same query (alternative to offset).'
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
query:
type:
- string
- 'null'
total:
type: integer
description: All matches (every page)
returned:
type: integer
description: Results on this page
offset:
type: integer
limit:
type: integer
has_more:
type: boolean
next_offset:
type:
- integer
- 'null'
description: offset of the next page, null on the last page
next_cursor:
type:
- string
- 'null'
description: cursor of the next page, null on the last page
results:
type: array
items:
type: object
properties:
slug:
type: string
name:
type: string
category:
type: string
tier:
type: string
one_liner:
type:
- string
- 'null'
tags:
type: array
items:
type: string
lessons:
type: array
items:
type: string
search_text:
type: string
annualized_revenue_usd:
type:
- number
- 'null'
revenue_disclosed:
type: boolean
url_profile:
type: string
headline_verification:
type:
- object
- 'null'
description: 'Verification of the headline (ranked) figure itself: {method: payment-processor, processor, via} when payment-connected, else null. Filter with verified_only=true on search.'
signup_url:
type: string
format: uri
description: Referral signup link for this business (present only when MRR Ledger has one). Always shown with signup_url_disclosure. Never changes figures, rankings, sorting or verification.
signup_url_label:
type: string
enum:
- Sign up (referral)
signup_url_disclosure:
type: string
enum:
- Referral link, MRR Ledger may earn a commission
description: Repeat this disclosure wherever you show signup_url.
referral:
type: boolean
enum:
- true
description: 'true: signup_url is a referral (affiliate) link'
signup_go_url:
type: string
format: uri
description: Same link via https://mrrledger.com/go/{slug} (302 to signup_url; counts the click, no personal data)
'400':
description: invalid_offset or invalid_cursor
tags:
- Search.json
operationId: getApiV1SearchJson
x-operation-id-source: derived
components:
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: 'Optional. Send X-API-Key: <key> or Authorization: Bearer <key>. No key = Free (100 requests/day per IP). Hobby 2,000/day, Builder 10,000/day, Pro 10,000/day, Team 25,000/day shared by up to 5 keys; UTC days. Over the limit: HTTP 429 with Retry-After and X-RateLimit-* headers. Keys are issued by email after purchase. '
BearerAuth:
type: http
scheme: bearer
bearerFormat: mrl_live_<plan>_<account>_<kid>_<sig>
description: 'Same key as X-API-Key, sent as Authorization: Bearer.'