API Referencev1

Minbar.ai API

Programmatic access to Gulf AI talent matching. Find the perfect speaker for your next event, generate speaker profiles, cultural briefs, and demand reports.

Authentication

!

API Keys Coming Soon

The Minbar.ai API is currently in beta. Contact us at api@minbar.ai for early access and API key provisioning.

Base URL

https://minbar.ai/api

Endpoints

GET/v1/match

Find matching AI experts based on topic, budget, and engagement type.

Query Parameters

ParameterTypeRequiredDescription
topicstringOptionalTopic to match against (e.g. 'AI Ethics', 'Deep Learning')
budgetnumberOptionalMaximum budget in USD
countrystringOptionalTarget country (e.g. 'UAE', 'KSA')
typestringOptionalEngagement type: keynote, halfday, workshop, virtual
limitnumberOptionalNumber of results to return(default: 3)

Example Request

bash
curl -X GET \
  "https://minbar.ai/api/v1/match?topic=AI+Ethics&budget=50000&country=UAE&type=keynote&limit=3"

Example Response

json
{
  "matches": [
    {
      "name": "Mo Gawdat",
      "slug": "mo-gawdat",
      "title": "Former Chief Business Officer, Google X",
      "specialization": "AI & Human Happiness",
      "relevanceScore": 95,
      "gulfVoiceScore": 96,
      "fee": {
        "keynote": "$45,000",
        "halfDay": "$25,000",
        "workshop": "$20,000",
        "virtual": "$10,000"
      },
      "availability": "May 2026",
      "profileUrl": "/experts/mo-gawdat",
      "photo": "/experts/mo-gawdat.jpg",
      "topRelevantTopics": [
        "Scary Smart: The Future of AI",
        "AI & The Future of Humanity",
        "Leadership in the Age of AI"
      ],
      "gulfExperience": [
        "GITEX Global 2023",
        "Dubai Future Forum 2022",
        "World Government Summit 2023"
      ]
    }
  ],
  "meta": {
    "query": {
      "topic": "AI Ethics",
      "budget": 50000,
      "country": "UAE",
      "engagementType": "keynote",
      "limit": 3
    },
    "totalExperts": 9,
    "matchedAt": "2026-03-29T12:00:00.000Z"
  }
}
POST/v1/match

Find matching AI experts with advanced filtering. Supports audience size for more refined matching.

Request Body

FieldTypeRequiredDescription
topicstringOptionalTopic to match against
budgetnumberOptionalMaximum budget in USD
countrystringOptionalTarget country
engagementTypestringOptionalEngagement type: keynote, halfday, workshop, virtual
audienceSizenumberOptionalExpected audience size
limitnumberOptionalNumber of results to return(default: 3)

Example Request

bash
curl -X POST https://minbar.ai/api/v1/match \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "AI Ethics",
    "budget": 50000,
    "country": "UAE",
    "engagementType": "keynote",
    "audienceSize": 500,
    "limit": 3
  }'

Example Response

Same response format as GET /v1/match above.

GET/speaker-profile/{slug}

Generate a comprehensive PDF speaker profile for a given expert.

Path Parameters

ParameterTypeRequiredDescription
slugstringRequiredExpert's URL slug (e.g. 'mo-gawdat', 'fei-fei-li')

Example Request

bash
curl -X GET "https://minbar.ai/api/speaker-profile/mo-gawdat" --output mo-gawdat-profile.pdf

Response

Returns a PDF file (application/pdf) containing the expert's full speaker profile with bio, topics, fees, Gulf experience, and verified bookings.

GET/cultural-brief/{slug}

Generate a cultural preparation brief for hosting an expert in the Gulf region.

Path Parameters

ParameterTypeRequiredDescription
slugstringRequiredExpert's URL slug

Example Request

bash
curl -X GET "https://minbar.ai/api/cultural-brief/mo-gawdat" --output mo-gawdat-brief.pdf

Response

Returns a PDF file (application/pdf) with cultural guidelines, protocol recommendations, and preparation notes for hosting this expert in the GCC.

GET/demand-report/{slug}

Generate a market demand report for a specific expert in the Gulf region.

Path Parameters

ParameterTypeRequiredDescription
slugstringRequiredExpert's URL slug

Example Request

bash
curl -X GET "https://minbar.ai/api/demand-report/mo-gawdat" --output mo-gawdat-demand.pdf

Response

Returns a PDF file (application/pdf) with demand analytics, booking trends, and market insights for this expert across the Gulf region.

Code Examples

GET Request

bash
curl -X GET \
  "https://minbar.ai/api/v1/match?topic=AI+Ethics&budget=50000&country=UAE&type=keynote&limit=3"

POST Request

bash
curl -X POST https://minbar.ai/api/v1/match \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "AI Ethics",
    "budget": 50000,
    "country": "UAE",
    "engagementType": "keynote",
    "audienceSize": 500,
    "limit": 3
  }'

Speaker Profile PDF

bash
curl -X GET "https://minbar.ai/api/speaker-profile/mo-gawdat" --output mo-gawdat-profile.pdf

Cultural Brief PDF

bash
curl -X GET "https://minbar.ai/api/cultural-brief/mo-gawdat" --output mo-gawdat-brief.pdf

Demand Report PDF

bash
curl -X GET "https://minbar.ai/api/demand-report/mo-gawdat" --output mo-gawdat-demand.pdf

Rate Limits

100
Requests per hour
1,000
Requests per day
10 MB
Max response size

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. If you exceed the limit, you will receive a 429 status code.

Need higher limits?

Enterprise plans include higher rate limits, webhook support, priority matching, and dedicated support for Gulf-focused AI talent acquisition.

Contact Us for Enterprise Access