Machine-readable resources, API documentation, and integration guides for Morocco's travel marketplace.
YALA-BINA is a travel marketplace connecting travelers with verified Moroccan travel agencies. The platform offers organized trips across Morocco, international destinations, and Omra pilgrimages.
| Resource | URL | Format |
|---|---|---|
| OpenAPI Spec | /openapi.json | JSON (OpenAPI 3.1) |
| Sitemap | /sitemap.xml | XML |
| LLM Summary | /llms.txt | Plain text |
| Crawl Rules | /robots.txt | Plain text |
Request the homepage with Accept: text/markdown to receive a structured markdown summary with live trip and agency listings:
curl -H "Accept: text/markdown" https://yala-bina.com/
The response includes Vary: Accept, Accept-Encoding for correct CDN caching.
All pages are server-side rendered for search engine crawlers. Trip detail pages (/trips/:slug) return full structured data (JSON-LD) for bots.
Filter trips by category, destination, departure city, date, and price.
| Parameter | Type | Description |
|---|---|---|
categories | string | Comma-separated: omra, morocco-domestic, international, adventure, desert, mountain, beach-coast, city-cultural |
regions | string | Comma-separated region filters |
departure_cities | string | Comma-separated city names (Casablanca, Marrakech, Fes, Rabat, Tanger, Agadir, Meknes, Tetouan, Essaouira, Chefchaouen) |
destination | string | Free-text search |
sortBy | string | newest (default), price, price_desc, duration, popularity |
Full trip listing with itinerary, pricing matrix, photos, departure dates, and agency info. Returns JSON-LD structured data for search engine bots.
Public profile of a verified travel agency with their active trip listings and contact information.
Travel articles and guides about Morocco and international destinations.
Visa assistance services for various destinations.
All API endpoints return structured JSON errors:
{
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found.",
"status": 404
},
"links": {
"sitemap": "https://yala-bina.com/sitemap.xml",
"openapi": "https://yala-bina.com/openapi.json",
"developers": "https://yala-bina.com/developers"
}
}
YALA-BINA uses Supabase (PostgreSQL + PostgREST) as its data layer. The Supabase API is authenticated and not publicly exposed. To access trip data programmatically, use the public pages and machine-readable resources listed above.
| Resource | Limit |
|---|---|
| Public pages | No hard limit; observe Crawl-delay: 1 in robots.txt |
| Sitemap | Cached for 1 hour |
| Markdown negotiation | Cached for 5 minutes |
The platform supports French (primary), Arabic, and English. Use the Accept-Language header or URL prefixes (/en/, /ar/, /fr/) to request content in a specific language.