API Documentation

Build powerful integrations with the MapEmbed API

Authentication

All API requests require authentication using an API key. You can generate API keys from your dashboard.

API Key Usage

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.mapembed.com/v1/maps

Note: Keep your API keys secure. Never commit them to public repositories or expose them in client-side code.

API Endpoints

GET /v1/maps

Retrieve all maps for the authenticated user.

Response

{
  "maps": [
    {
      "id": "map123",
      "title": "My Map",
      "published": true,
      "views": 1234,
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ]
}
POST /v1/maps

Create a new map.

Request Body

{
  "title": "My New Map",
  "description": "A beautiful map",
  "published": false
}

Response

{
  "id": "map456",
  "title": "My New Map",
  "description": "A beautiful map",
  "published": false,
  "createdAt": "2026-02-08T14:20:00Z"
}
PUT /v1/maps/:id

Update an existing map.

Request Body

{
  "title": "Updated Map Title",
  "published": true
}
DELETE /v1/maps/:id

Delete a map.

Response

{
  "success": true,
  "message": "Map deleted successfully"
}

Rate Limits

Free Plan 100 requests/hour
Pro Plan 1,000 requests/hour
Enterprise Plan 10,000 requests/hour

Need Help?

For additional API support or questions, please contact our development team.

Contact Support