API REST v1

export MULTILISTADO_API_KEY="pbm_..."   # tu key
API=https://multilistado.mx/api/v1
curl -s "$API/me" -H "Authorization: Bearer $MULTILISTADO_API_KEY"

// Node.js 18+ (archivo .mjs). Nunca en el navegador: expondría tu key.
const API = 'https://multilistado.mx/api/v1';
async function api(method, path, body) {
  const res = await fetch(API + path, {
    method,
    headers: { Authorization: `Bearer ${process.env.MULTILISTADO_API_KEY}`, ...(body ? { 'Content-Type': 'application/json' } : {}) },
    body: body ? JSON.stringify(body) : undefined
  });
  const data = await res.json().catch(() => ({}));
  if (!res.ok) throw new Error(`${res.status} ${data.message || data.error || ''} ${(data.errors || []).join(' ')}`);
  return data;
}
const me = await api('GET', '/me');
console.log(me.name, me.scopes);

<?php
// PHP 7.4+ con la extensión curl.
function mlx(string $method, string $path, ?array $body = null): array {
    $ch = curl_init('https://multilistado.mx/api/v1' . $path);
    $headers = ['Authorization: Bearer ' . getenv('MULTILISTADO_API_KEY'), 'Accept: application/json'];
    if ($body !== null) {
        $headers[] = 'Content-Type: application/json';
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    }
    curl_setopt_array($ch, [CURLOPT_CUSTOMREQUEST => $method, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $headers, CURLOPT_TIMEOUT => 30]);
    $raw = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $data = json_decode((string) $raw, true) ?: [];
    if ($code >= 400 || $raw === false) {
        throw new RuntimeException($code . ' ' . ($data['message'] ?? $data['error'] ?? curl_error($ch)) . ' ' . implode(' ', $data['errors'] ?? []));
    }
    return $data;
}
$me = mlx('GET', '/me');
echo $me['name'], PHP_EOL;

# Python 3.8+ con requests (pip install requests)
import os, requests

API = "https://multilistado.mx/api/v1"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['MULTILISTADO_API_KEY']}"

def api(method, path, **kwargs):
    r = session.request(method, API + path, timeout=30, **kwargs)
    data = r.json() if r.content else {}
    if not r.ok:
        raise RuntimeError(f"{r.status_code} {data.get('message') or data.get('error')} {' '.join(data.get('errors', []))}")
    return data

me = api("GET", "/me")
print(me["name"], me["scopes"])

curl -s -G "$API/properties" -H "Authorization: Bearer $MULTILISTADO_API_KEY" \
  --data-urlencode "city=Tijuana" --data-urlencode "operation=sale" --data-urlencode "type=house" \
  --data-urlencode "min_price=2000000" --data-urlencode "sort=price_asc" --data-urlencode "limit=10"

const qs = new URLSearchParams({ city: 'Tijuana', operation: 'sale', type: 'house', min_price: '2000000', sort: 'price_asc', limit: '10' });
const { pagination, content } = await api('GET', `/properties?${qs}`);
console.log(`${pagination.total} resultados, página ${pagination.page} de ${pagination.pages}`);
for (const l of content) console.log(l.title, '·', l.operations[0]?.formatted_amount, '·', l.agent.name);

$qs = http_build_query(['city' => 'Tijuana', 'operation' => 'sale', 'type' => 'house', 'min_price' => 2000000, 'sort' => 'price_asc', 'limit' => 10]);
$page = mlx('GET', "/properties?$qs");
echo $page['pagination']['total'], " resultados", PHP_EOL;
foreach ($page['content'] as $l) {
    echo $l['title'], ' · ', $l['operations'][0]['formatted_amount'] ?? '', ' · ', $l['agent']['name'], PHP_EOL;
}

page = api("GET", "/properties", params={"city": "Tijuana", "operation": "sale", "type": "house",
                                          "min_price": 2000000, "sort": "price_asc", "limit": 10})
print(page["pagination"]["total"], "resultados")
for l in page["content"]:
    print(l["title"], "·", l["operations"][0]["formatted_amount"] if l["operations"] else "", "·", l["agent"]["name"])

curl -s "$API/properties/casa-en-venta-playas-de-tijuana" -H "Authorization: Bearer $MULTILISTADO_API_KEY"

const one = await api('GET', `/properties/${content[0].id}`);
console.log(one.title, one.url, one.images.length, 'fotos');

$one = mlx('GET', '/properties/' . $page['content'][0]['id']);
echo $one['title'], ' ', $one['url'], PHP_EOL;

one = api("GET", f"/properties/{page['content'][0]['id']}")
print(one["title"], one["url"], len(one["images"]), "fotos")

curl -s -X POST "$API/properties" -H "Authorization: Bearer $MULTILISTADO_API_KEY" -H "Content-Type: application/json" -d '{
  "title": "Casa en venta en Playas de Tijuana", "description": "Casa de 3 recámaras a dos cuadras de la playa.",
  "property_type": "house", "sale_price": 4500000, "sale_currency": "MXN",
  "bedrooms": 3, "bathrooms": 2.5, "parking": 2, "construction_m2": 180, "lot_m2": 200,
  "city": "Tijuana", "state": "Baja California", "neighborhood": "Playas de Tijuana",
  "lat": 32.5201, "lng": -117.1205, "features": ["Vista al mar", "Jardín"], "external_id": "crm-1042"
}'
# Guarda el "id" de la respuesta:
LISTING_ID="…"

const created = await api('POST', '/properties', {
  title: 'Casa en venta en Playas de Tijuana', description: 'Casa de 3 recámaras a dos cuadras de la playa.',
  property_type: 'house', sale_price: 4500000, sale_currency: 'MXN',
  bedrooms: 3, bathrooms: 2.5, parking: 2, construction_m2: 180, lot_m2: 200,
  city: 'Tijuana', state: 'Baja California', neighborhood: 'Playas de Tijuana',
  lat: 32.5201, lng: -117.1205, features: ['Vista al mar', 'Jardín'], external_id: 'crm-1042'
});
const id = created.id;
console.log(created.status, created.url);   // draft https://multilistado.mx/p/…

$created = mlx('POST', '/properties', [
    'title' => 'Casa en venta en Playas de Tijuana', 'description' => 'Casa de 3 recámaras a dos cuadras de la playa.',
    'property_type' => 'house', 'sale_price' => 4500000, 'sale_currency' => 'MXN',
    'bedrooms' => 3, 'bathrooms' => 2.5, 'parking' => 2, 'construction_m2' => 180, 'lot_m2' => 200,
    'city' => 'Tijuana', 'state' => 'Baja California', 'neighborhood' => 'Playas de Tijuana',
    'lat' => 32.5201, 'lng' => -117.1205, 'features' => ['Vista al mar', 'Jardín'], 'external_id' => 'crm-1042',
]);
$id = $created['id'];
echo $created['status'], ' ', $created['url'], PHP_EOL;

created = api("POST", "/properties", json={
    "title": "Casa en venta en Playas de Tijuana", "description": "Casa de 3 recámaras a dos cuadras de la playa.",
    "property_type": "house", "sale_price": 4500000, "sale_currency": "MXN",
    "bedrooms": 3, "bathrooms": 2.5, "parking": 2, "construction_m2": 180, "lot_m2": 200,
    "city": "Tijuana", "state": "Baja California", "neighborhood": "Playas de Tijuana",
    "lat": 32.5201, "lng": -117.1205, "features": ["Vista al mar", "Jardín"], "external_id": "crm-1042",
})
listing_id = created["id"]
print(created["status"], created["url"])

curl -s -X PUT "$API/properties/$LISTING_ID" -H "Authorization: Bearer $MULTILISTADO_API_KEY" -H "Content-Type: application/json" \
  -d '{"sale_price": 4350000, "title_en": "House for sale in Playas de Tijuana"}'

const updated = await api('PUT', `/properties/${id}`, { sale_price: 4350000, title_en: 'House for sale in Playas de Tijuana' });
console.log(updated.operations[0].formatted_amount);   // $4,350,000 MXN

$updated = mlx('PUT', "/properties/$id", ['sale_price' => 4350000, 'title_en' => 'House for sale in Playas de Tijuana']);
echo $updated['operations'][0]['formatted_amount'], PHP_EOL;

updated = api("PUT", f"/properties/{listing_id}", json={"sale_price": 4350000, "title_en": "House for sale in Playas de Tijuana"})
print(updated["operations"][0]["formatted_amount"])

curl -s -X POST "$API/properties/$LISTING_ID/images" -H "Authorization: Bearer $MULTILISTADO_API_KEY" -H "Content-Type: application/json" \
  -d '{"urls": ["https://cdn.tu-sitio.com/fotos/1042/fachada.jpg", "https://cdn.tu-sitio.com/fotos/1042/sala.jpg"]}'

const media = await api('POST', `/properties/${id}/images`, { urls: ['https://cdn.tu-sitio.com/fotos/1042/fachada.jpg', 'https://cdn.tu-sitio.com/fotos/1042/sala.jpg'] });
console.log(media.media.length, 'imágenes');

$media = mlx('POST', "/properties/$id/images", ['urls' => ['https://cdn.tu-sitio.com/fotos/1042/fachada.jpg', 'https://cdn.tu-sitio.com/fotos/1042/sala.jpg']]);
echo count($media['media']), ' imágenes', PHP_EOL;

media = api("POST", f"/properties/{listing_id}/images", json={"urls": ["https://cdn.tu-sitio.com/fotos/1042/fachada.jpg", "https://cdn.tu-sitio.com/fotos/1042/sala.jpg"]})
print(len(media["media"]), "imágenes")

curl -s -X POST "$API/properties/$LISTING_ID/publish" -H "Authorization: Bearer $MULTILISTADO_API_KEY"
# {"ok":true,"status":"published"}

console.log(await api('POST', `/properties/${id}/publish`));   // { ok: true, status: 'published' }

print_r(mlx('POST', "/properties/$id/publish"));

print(api("POST", f"/properties/{listing_id}/publish"))

curl -s -X POST "$API/leads" -H "Authorization: Bearer $MULTILISTADO_API_KEY" -H "Content-Type: application/json" \
  -d "{\"name\": \"Ana López\", \"email\": \"ana@example.com\", \"phone\": \"+52 664 123 4567\", \"message\": \"Me interesa la casa.\", \"property_id\": \"$LISTING_ID\", \"source\": \"mi-sitio\"}"

const lead = await api('POST', '/leads', { name: 'Ana López', email: 'ana@example.com', phone: '+52 664 123 4567', message: 'Me interesa la casa.', property_id: id, source: 'mi-sitio' });
console.log(lead.id, lead.listing_title);

$lead = mlx('POST', '/leads', ['name' => 'Ana López', 'email' => 'ana@example.com', 'phone' => '+52 664 123 4567', 'message' => 'Me interesa la casa.', 'property_id' => $id, 'source' => 'mi-sitio']);
echo $lead['id'], ' ', $lead['listing_title'], PHP_EOL;

lead = api("POST", "/leads", json={"name": "Ana López", "email": "ana@example.com", "phone": "+52 664 123 4567",
                                   "message": "Me interesa la casa.", "property_id": listing_id, "source": "mi-sitio"})
print(lead["id"], lead["listing_title"])

curl -s "$API/leads" -H "Authorization: Bearer $MULTILISTADO_API_KEY"

const { content: leads } = await api('GET', '/leads');
for (const l of leads.slice(0, 5)) console.log(l.created_at, l.name, l.kind, l.source, l.listing_title);

$leads = mlx('GET', '/leads')['content'];
foreach (array_slice($leads, 0, 5) as $l) {
    echo $l['created_at'], ' ', $l['name'], ' ', $l['kind'], ' ', $l['source'], PHP_EOL;
}

leads = api("GET", "/leads")["content"]
for l in leads[:5]:
    print(l["created_at"], l["name"], l["kind"], l["source"], l["listing_title"])