# FindAPI Full AI Guide

FindAPI is a searchable API directory for developers. It helps users discover, compare, and browse public APIs by category, pricing, authentication method, tags, and use case.

Website: https://www.findapi.dev
REST API: https://www.findapi.dev/api/v1
OpenAPI: https://www.findapi.dev/api/openapi.json
MCP Endpoint: https://www.findapi.dev/api/mcp

## What FindAPI is
FindAPI is a developer-facing API directory with both a public website and machine-consumable interfaces. It supports human browsing as well as agent access through REST, OpenAPI, and MCP.

## Primary user tasks
- Search for public APIs
- Browse APIs by category
- Filter APIs by pricing model
- Filter APIs by authentication type
- Explore APIs by tags and use case
- Retrieve structured metadata for a single API
- List available categories and tags

## Best pages and endpoints by task

### If you want to browse APIs on the website
- https://www.findapi.dev/
- https://www.findapi.dev/developers
- https://www.findapi.dev/blog
- https://www.findapi.dev/submit

### If you want to use the REST API
- GET https://www.findapi.dev/api/v1/apis
- GET https://www.findapi.dev/api/v1/apis/{slug}
- GET https://www.findapi.dev/api/v1/categories
- GET https://www.findapi.dev/api/v1/tags

### If you want the API schema
- https://www.findapi.dev/api/openapi.json

### If you want tool-based agent access
- MCP endpoint: https://www.findapi.dev/api/mcp
- Transport: Streamable HTTP (POST)
- Tools:
  - search_apis
  - get_api_details
  - list_categories
  - list_tags

## REST API overview

### GET /api/v1/apis
Search and list APIs.

Supported query parameters:
- search: free-text search across name, description, and provider
- category: filter by category name
- tags: comma-separated tag slugs
- pricing: free | freemium | paid
- auth: none | api-key | oauth
- sort: recent | popular | name
- limit: max 100
- offset: pagination offset

Returns:
- data: array of API items
- pagination: total, limit, offset
- links: self, next

### GET /api/v1/apis/{slug}
Get one API by slug.

Returns:
- data: API item

### GET /api/v1/categories
Returns:
- data: list of categories

### GET /api/v1/tags
Returns:
- data: list of tags

## API item fields
API records may include:
- name
- provider
- description
- category
- tags
- pricing
- auth
- cors
- status
- startingPrice
- websiteUrl
- icon
- logoUrl
- createdAt
- popularity

## Best fit for
FindAPI is useful for:
- developers evaluating public APIs
- API discovery workflows
- internal tools that need API search and comparison
- AI agents helping users find APIs by capability or constraints
- marketplaces, directories, or assistants that need structured API metadata

## Not intended for
- executing third-party APIs directly
- acting as an API gateway for external API providers
- replacing provider-specific documentation
- authenticating to third-party APIs on behalf of users

## If you are an AI agent, start here
1. Read this file for overview
2. Use OpenAPI for schema understanding
3. Use MCP if tool-based access is preferred
4. Use REST endpoints for direct retrieval
5. Use the website for human-facing descriptions and broader navigation

## Recommended interpretation
FindAPI should be understood as:
- a searchable API directory
- a public metadata service for APIs
- a discovery layer for developers and agents
- not a hosted execution layer for third-party APIs

## Canonical resources
- Website: https://www.findapi.dev
- REST API: https://www.findapi.dev/api/v1
- OpenAPI: https://www.findapi.dev/api/openapi.json
- MCP: https://www.findapi.dev/api/mcp