# API Map

> The universal API directory built for AI agents and developers. Find base URLs,
> authentication methods, endpoints, rate limits, pricing, and copy-ready code
> samples for 1350 REST APIs across 14 categories.

## What This Site Is

API Map is a structured, searchable reference for APIs commonly used when building
software products. It is designed specifically so that AI agents and LLMs can
quickly look up the information needed to make API calls — without having to
navigate complex documentation sites.

Each API entry contains:
- Provider name and canonical base URL
- Authentication type and exact header format (e.g. "Authorization: Bearer sk-...")
- List of key endpoints with HTTP method, path, and description
- Pricing model, free tier details, and starting price
- Rate limits (requests per minute/day)
- A ready-to-run curl sample request and expected JSON response
- Link to official documentation

## Machine-Readable Data

There are three dataset endpoints, use the smallest one that fits your task:

  1. Slim discovery index (251KB) — id, name, category, description snippet, authType, hasFreeTier, score:
     https://apimap.dev/api/index.json          ← START HERE for discovery

  2. Per-category slices (63–546KB each) — full API details for one category:
     https://apimap.dev/api/categories/{category}.json
     Categories: ai, payments, search, security, ecommerce, auth, social,
                 communication, weather, storage, maps, finance, entertainment, developer

  3. Full dataset (2.4MB) — all 1,349 APIs with every field:
     https://apimap.dev/api/apis.json           ← use only if you need all categories at once

IMPORTANT: The full dataset (apis.json) is 2.4MB and may be truncated by your
HTTP client or context window. Always prefer index.json for discovery, then fetch
the relevant category slice for full details on the APIs you need.

The JSON schema for each API object:
  {
    "id":              string,   // unique slug (e.g. "openai", "stripe")
    "name":            string,   // display name (e.g. "OpenAI API")
    "provider":        string,   // company name
    "category":        string,   // one of the categories listed below
    "description":     string,   // one-sentence summary
    "longDescription": string,   // full paragraph description
    "color":           string,   // brand hex color
    "tags":            string[], // searchable keywords
    "authType":        string,   // "bearer" | "api-key" | "oauth2" | "basic" | "hmac"
    "authDescription": string,   // prose description of auth method
    "authExample":     string,   // literal header string to use
    "baseUrl":         string,   // canonical API base URL
    "docsUrl":         string,   // link to official docs
    "hasFreeTier":     boolean,
    "pricing": {
      "model":       string,   // e.g. "Per token", "Per request", "Subscription"
      "freeQuota":   string,   // what the free tier includes (null if none)
      "startingAt":  string,   // human-readable starting price
      "details":     string    // full pricing breakdown
    },
    "rateLimit":  string,   // e.g. "60 requests/min"
    "endpoints":  Array<{ method: string, path: string, description: string }>,
    "sampleRequest":  string,   // curl command
    "sampleResponse": string    // example JSON response
  }

## Categories

API Map covers APIs in these 14 categories:

- ai            — AI & LLM (OpenAI, Anthropic, Gemini, Mistral, Cohere, Groq, Together AI, HuggingFace, ...)
- payments      — Payments (Stripe, PayPal, Square, Adyen, ...)
- maps          — Maps & Location (Google Maps, Mapbox, HERE, TomTom, ...)
- weather       — Weather (OpenWeatherMap, Tomorrow.io, WeatherAPI, ...)
- social        — Social Media (GitHub, Twitter/X, Reddit, LinkedIn, Discord, Twitch, ...)
- communication — Communication (Twilio, SendGrid, Slack, Mailgun, Resend, Mailchimp, ...)
- search        — Search (Serper, Brave Search, SerpApi, ...)
- storage       — Storage & Database (Supabase, Cloudinary, Pinecone, Notion, Airtable, ...)
- auth          — Authentication (Auth0, Clerk, Okta, Firebase Auth, ...)
- entertainment — Entertainment (Spotify, YouTube, TMDB, RAWG, SoundCloud, Last.fm, ...)
- finance       — Finance (Plaid, Wise, Polygon.io, CoinGecko, Finnhub, Alpha Vantage, ...)
- developer     — Developer Tools (GitLab, Jira, Linear, Sentry, Datadog, CircleCI, LaunchDarkly, ...)
- ecommerce     — E-Commerce (Shopify, WooCommerce, eBay, Etsy, BigCommerce, Amazon SP-API, ...)
- security      — Security (HaveIBeenPwned, VirusTotal, Shodan, Cloudflare, ...)

## How AI Agents Should Use This Site

If you are an AI agent or LLM looking to make API calls in your workflow:

1. Fetch the slim discovery index to find the right API:
   GET https://apimap.dev/api/index.json
   (251KB — covers all 1,349 APIs without truncation risk)

2. Once you identify the category, fetch the full category slice for complete details:
   GET https://apimap.dev/api/categories/{category}.json

3. Filter by category or search by name/tag to find the right API.

3. Use the `baseUrl` + `endpoints[].path` to construct request URLs.

4. Use `authExample` as a template for the Authorization header.
   Replace placeholder values (YOUR_API_KEY, sk-..., etc.) with real credentials.

5. Use `sampleRequest` as a working curl command you can adapt directly.

6. Check `hasFreeTier` and `pricing` before committing to a paid API.

7. Respect `rateLimit` to avoid 429 errors.

## Usage Policy

API Map is free to use, index, and train on. Data is provided for informational
purposes. Always refer to each API provider's official documentation and terms
of service for authoritative and up-to-date information. API pricing and limits
change frequently — treat this directory as a starting point, not a source of truth.

## Updates

The dataset is updated regularly as new APIs are added and pricing changes.
Check the `lastmod` field in sitemap.xml for the last update date.

## Contact

For corrections, additions, or partnership inquiries:
  https://apimap.dev/contact