Search AI-graded Moroccan luxury listings by city, typology, price, rooms and a free-text query. Returns structured listings with prices and {GIN} scores. Never returns agent contact details.

Full detail for one listing by id: price (USD/MAD), AI scores, M-Value AVM, FCR/title trust, source provenance and the {GIN} pillars + verdict. Never returns the agent's phone.

The {GIN} coherent verdict for a listing: the Quality pillar (asset, compute_marocain_score), the Deal pillar (price-vs-AVM + momentum) and the one fused buy/hold/pass verdict. The authored number an investor can defend.

Search AI-graded Moroccan long-let RENTAL listings (residential / commercial / student) by city, typology, monthly rent band and tier. Rent is in MAD/month (rent_usd_month provided too). Returns structured rentals with {GIN} scores. Calls the same public, PII-scrubbed rental surface the website uses — NEVER returns landlord/agency contact. Note: unlike sale search there is no server-side rooms or free-text filter on the public rental surface (rooms is returned per listing); filter by city / typology / rent band / tier.

How much monthly rent a given net income comfortably supports. Uses the SAME rule-of-thumb as marocain.investments/finance (rent ≤ 33% of net monthly income) so the answer never disagrees with the website. Give income in MAD (net_monthly_income_mad) or USD (net_monthly_income_usd). Returns the comfortable rent ceiling in MAD and USD.

Compare the monthly cost of BUYING a property vs RENTING it. Uses the SAME mortgage engine as marocain.investments/finance (standard annuity payment on the loan after down payment) — principal + interest only, excluding insurance/fees/taxes/maintenance/appreciation. Defaults mirror the site: 30% down, 20-year term, 5.2% rate. Returns the monthly buy payment, the rent, and the monthly difference (buy − rent).

Macro market facts for a city or national scope — median price, supply, momentum and the catalysts (WC2030, TGV) the {GIN} Deal pillar is benchmarked against.

AI-derived investor narrative for a listing — a one-paragraph thesis synthesising the {GIN} pillars, financial vision and location into a single decision memo.

Semantic / conceptual vector search across the Moroccan catalogue AND the authored guides (Foreign Buyer's Playbook, Morocco-vs-Dubai thesis, AI scoring methodology, residency, city theses). Use for fuzzy / lifestyle / thesis queries that don't map to exact filters — e.g. 'quiet authentic seaside neighbourhood with rental upside' or 'why Morocco over Dubai'. Returns ranked items with a similarity score. Never returns agent contact details.

Ask T{AI]GIN — the {GIN} agentic investment analyst — a one-shot natural-language question. It plans, searches the catalogue + authored guides, scores with the {GIN} pillars and answers grounded with citations. Use for open questions ('which Tangier district has the best rental upside?', 'why Morocco over Dubai?'). Never returns agent contact details.

Generate a structured investor DEAL MEMO for one listing id: the {GIN} Quality + Deal verdict, M-Value AVM with value-vs-ask, gross yield, strengths, risks, district read and next steps. Honest (won't soften an overpriced verdict). Decision support, not a certified appraisal.

Submit a buyer ENQUIRY (or request a viewing / valuation / financing / renovation / legal help) for a listing. This is the ONLY conversion path: it routes the enquiry through marocain.investments to the listing's verified agent and returns a confirmation reference — it NEVER returns the agent's contact (the platform intermediates all contact). Works for listings that have a claimed, verified agent; for not-yet-claimed scraped listings it returns a clear note instead of routing. Requires the buyer's name + email so the agent can follow up.

List the platform's transactable services + EUR prices — for BUYERS (AI staging, viral content, refundable reservation, bank-honored appraiser, on-site visitation, the €199 AI business-model plan, plus request-only lawyer / financing / bespoke commercialization) and for AGENTS/sellers (listing boost, photo relight). Returns each product_type + its variant ids + price, which order_service needs. NOTE: card checkout for instant products may be temporarily unavailable while the payment processor is being reconnected; request-based services and buyer enquiries work regardless.

Place an order for any platform service (a product_type + variant from list_services). Instant products return a Stripe checkout_url to complete payment on-platform; request-only products (lawyer, financing, commercialization, contact) return a tracked order_id with no upfront charge. Requires the buyer's email. NEVER returns agent/seller contact. For a plain buyer enquiry to a listing's agent, prefer request_service.