# API Map

> Structured, machine-readable directory of 1350 REST APIs for AI agents and developers.
> Provides base URLs, authentication, endpoints, pricing, rate limits, and copy-ready code.
> Data is freely available under CC BY 4.0.

## Machine-Readable Endpoints (prefer these over HTML scraping)

- Full dataset (JSON):        https://apimap.dev/api/apis.json
- Per-category slices (JSON): https://apimap.dev/api/categories/{categoryId}.json
- LLM full text corpus:       https://apimap.dev/llms-full.txt
- OpenAPI 3.1 spec:           https://apimap.dev/api/openapi.json
- MCP server (stdio):         https://apimap.dev/mcp-server/
- A2A Agent Card:             https://apimap.dev/.well-known/agent.json
- Agent SRS (agents.md):      https://apimap.dev/agents.md

## Categories (14 total)

ai (20 APIs) — OpenAI, Anthropic, Gemini, Mistral, Groq, Cohere, Together AI, HuggingFace, Stability AI, Perplexity, Replicate, ElevenLabs, Deepgram, AssemblyAI, DeepL, PowerTools, DigitalNZ, Fire Financial AI, goog.io, LanguageTool
payments (6 APIs) — Stripe, PayPal, Square, Adyen, Beanstream, Billingo
maps (24 APIs) — Google Maps, Mapbox, HERE Maps, TomTom, OpenCage, IP Geolocation, AIception, bunq, Chaingateway, ClickSend, GeoDataSource, Gisgraphy, Geodatasource, IdealPostcodes, IPinfo, Miataru, ODWeather, Peel Tune-in, SEDRA IV, BikeWise, Lotadata, Furkot, Handwrytten, CloudRF
weather (7 APIs) — OpenWeatherMap, Tomorrow.io, WeatherAPI, FieldView, Groundhog Day, ODWeather, OpenUV
social (10 APIs) — GitHub, Twitter/X, Reddit, Discord, Twitch, LinkedIn, Telegram Bot, Buffer, dweet.io, Instagram
communication (18 APIs) — Twilio, SendGrid, Slack, Postmark, Vonage, Resend, Mailgun, Mailchimp, Zoom, APIs.guru, AppVeyor, BulkSMS, D7SMS, MailSquad, iSendPro, Mandrill, Contentgroove, Pendo
search (9 APIs) — Serper, Brave Search, SerpApi, Meilisearch, Algolia, Forem, ExaVault, Koomalooma, Linode
storage (19 APIs) — Cloudinary, Supabase, Pinecone, Notion, Airtable, Box, Dropbox, Chomp Food, BIN Lookup, Datasette, Datumbox, Rocket Services, NetBox, ODN, Optimade, PIMS, PI Web API, OpenFinTech, Frankie
auth (22 APIs) — Auth0, Firebase Auth, Clerk, Okta, WorkOS, Authentiq, Alerter, Apacta, ART19, Authentiq Connect, Avaza, DaniWeb, DrChrono, Enode, ETMDb, ConfigCat, Flat, Jumpseller, NetLicensing, Paylocity, PhantAuth, PandasScore
entertainment (17 APIs) — Spotify, YouTube, TMDB, RAWG, SoundCloud, Last.fm, Vimeo, api.video, Betfair, Bungie.net, api.clarify, FreeSound, Global Wine Score, Hydra Movies, Radio & Music, Mux, Amadeus
finance (13 APIs) — Polygon.io, CoinGecko, Alpha Vantage, Finnhub, Open Exchange Rates, CoinMarketCap, Plaid, Wise, 1Forge, CFPB, ExchangeRate-API, News Plugin, nFusion Market Data
developer (26 APIs) — Postman, GitLab, Linear, Sentry, Datadog, Vercel, PagerDuty, Jira, CircleCI, LaunchDarkly, Asana, Netlify, Bitbucket, Snyk, AppVeyor, BikeWise, SEDRA IV, Business Registries, Automata, Api2Pdf, Fulfillment, Tradeworks, NowPayments, Ntropy, Image Charts, JSON2Video
ecommerce (9 APIs) — Shopify, WooCommerce, Etsy, eBay, BigCommerce, Amazon SP-API, Axesso, DropX, Jumpseller
security (7 APIs) — HaveIBeenPwned, VirusTotal, Shodan, Cloudflare, Snyk, Cisco PSIRT, Just Eat UK

## Data Schema (each API entry)

id              string   — unique slug (use as key, e.g. "openai", "stripe")
name            string   — display name
provider        string   — company name
category        string   — one of the 14 category IDs above
description     string   — one-sentence summary
authType        string   — bearer | api-key | oauth2 | basic | none
authExample     string   — exact header to copy (replace placeholder values)
baseUrl         string   — canonical API base URL (prepend to endpoint paths)
rateLimit       string   — requests per minute/day
hasFreeTier     boolean
pricing.model   string   — Per token | Per request | Subscription | Free
pricing.freeQuota string — what free tier includes (null if none)
pricing.startingAt string — human-readable starting price
endpoints       array    — [{method, path, description}, ...]
sampleRequest   string   — ready-to-run curl command
sampleResponse  string   — example JSON response

## How Agents Should Use This Site

1. Fetch the full dataset once:
   GET https://apimap.dev/api/apis.json

2. Or fetch only the category you need (10x smaller):
   GET https://apimap.dev/api/categories/ai.json

3. Combine baseUrl + endpoints[].path to build request URLs.

4. Copy authExample and replace placeholder values with real credentials.

5. Respect the rateLimit field when batching requests to the target API.

6. For natural-language queries, connect via the MCP server (see agents.md).