Developer PortalAPI v1.0.0

ListMySaaS API Documentation & Agent Portal

Welcome to the official ListMySaaS API reference and agent discovery hub. All public directory query endpoints and SEO analysis tools are available with Zero-Auth Access (no API keys required for public reads) and standard RFC rate-limiting headers.

Machine-Readable Specifications & Catalogs

OpenAPI 3.1 Specification

/openapi.json • /api/v1/openapi.json

LLMs.txt Site Overview

/llms.txt • /llms-full.txt

RFC 9727 API Catalog

/.well-known/api-catalog

MCP Server Card

/.well-known/mcp/server-card.json

Zero-Auth Access & Onboarding

To eliminate integration friction for autonomous AI agents, crawlers, and developers, ListMySaaS exposes all directory browsing, category listing, search, and SEO diagnostic tools with Zero-Auth access.

Free Tier: Free directory exploration, tool search, and web-based SEO analysis.
Zero-Auth: No signup, token generation, or API key needed for GET queries and tool analysis POST endpoints.
Sandbox / Test Mode: Live public directory acts as an open sandbox with idempotent responses.

API Versioning & Deprecation Policy

ListMySaaS APIs utilize explicit URL path versioning (e.g. /api/v1/...).

Deprecation Signaling: When an API version or endpoint is scheduled for sunset, responses will include standard Deprecation and Sunset HTTP headers (per RFC 8594) at least 90 days before retirement.

Rate Limiting & Response Headers

All API responses include standard IETF RateLimit and backwards-compatible headers:

RateLimit-Limit: 100

RateLimit-Remaining: 99

RateLimit-Reset: 60

RateLimit-Policy: 100;w=60

X-API-Version: 1.0.0

When a rate limit is exceeded (HTTP 429 Too Many Requests), the response will include a Retry-After: <seconds> header and an RFC 9457 structured error body.

REST Endpoints Reference (v1)

GET/api/v1/tools

List and search curated SaaS directory tools with optional query filters and pagination.

curl https://listmysaas.xyz/api/v1/tools?q=ai&limit=10

GET/api/v1/tools/{slug}

Get full profile details, metadata, score, and related alternatives for a specific SaaS tool.

curl https://listmysaas.xyz/api/v1/tools/prompt-builder

GET/api/v1/categories

List all 30+ SaaS categories with live listing counts and links.

curl https://listmysaas.xyz/api/v1/categories

POST/api/v1/tools/heading-analyzer

Audit H1-H6 heading hierarchy, word count, image alt tags, and internal/external link structure for any URL.

curl -X POST https://listmysaas.xyz/api/v1/tools/heading-analyzer -H "Content-Type: application/json" -d '{"url": "https://example.com"}'

POST/api/v1/tools/meta-analyzer

Analyze meta tags, OpenGraph properties, Twitter Cards, robots directives, and canonical URLs.

curl -X POST https://listmysaas.xyz/api/v1/tools/meta-analyzer -H "Content-Type: application/json" -d '{"url": "https://example.com"}'

Model Context Protocol (MCP) Server

ListMySaaS provides a native Model Context Protocol (MCP) server using Streamable HTTP transport. Claude Desktop, Cursor, ChatGPT, and autonomous agents can discover and call directory tools directly.

Endpoint: https://listmysaas.xyz/mcp

Manifest: https://listmysaas.xyz/.well-known/mcp/server-card.json

Transport: streamable-http (JSON-RPC 2.0)

Available Tools:

list_tools — Query and search tools by keyword, category, and score
get_tool — Fetch complete metadata and alternatives for any tool
list_categories — Retrieve 30+ categorized software indexes
analyze_headings — Extract and audit H1-H6 heading structure and word count
analyze_meta — Analyze SEO meta tags, OpenGraph, and Twitter Cards

Official CLI Tool (`listmysaas`)

Developers and autonomous scripts can interact with ListMySaaS directly from the command line using npx listmysaas:

# Search SaaS directory tools:

npx listmysaas list --query "ai" --limit 10

# Get tool details:

npx listmysaas get prompt-builder

# Audit webpage SEO & heading hierarchy:

npx listmysaas audit https://example.com

Markdown Content Negotiation (acceptmarkdown.com)

All public pages on ListMySaaS support Accept: text/markdown content negotiation or appending .md:

# Fetch clean Markdown via Accept header:

curl -H "Accept: text/markdown" https://listmysaas.xyz/directory

# Or fetch directly via .md extension:

curl https://listmysaas.xyz/directory.md