WithinEarth Hotel API Integration via Vervotech

Integration snapshot

Supplier

WithinEarth

Type

Bedbank or wholesaler

Origin country

Malaysia

Region

Asia Pacific

Coverage tier

Active coverage

Canonical mapping

Vervotech hotel + room IDs

Schema unification

Names, addresses, geocodes, amenities, room types, board types

Delivery

REST API, offline file sync, on-demand match

What Vervotech does for WithinEarth

• Canonical hotel IDs. Each WithinEarth property resolves to a single Vervotech hotel ID shared with every other connected supplier.
• Room-level mapping. Identical room types from WithinEarth collapse with peer suppliers' equivalents into a canonical room ID, so you can shop rates without duplicate inventory.
• Continuous refresh. Static and dynamic WithinEarth content is pulled on a recurring cycle, so newly contracted properties enter the mapped catalog without engineering work.
• One REST endpoint. Call WithinEarth content through the same Vervotech endpoint that serves the rest of your supplier mix.
• Bedbank deduplication. Where WithinEarth overlaps with peer bedbanks on the same property, Vervotech keeps a single canonical record and exposes both rate options under one listing.

How the WithinEarth integration works

1. Ingest. Vervotech pulls the WithinEarth hotel content feed on a continuous refresh cycle. Both static (hotel attributes) and structural (room and board types) data are captured.
2. Normalize. WithinEarth's schema is mapped to a canonical Vervotech model. Currency, language, geocoding, and amenity vocabularies are standardized.
3. Resolve. Every WithinEarth property is matched to a canonical Vervotech hotel ID using deterministic rules (address, geocode, name) and ML scoring trained on 3M+ properties.
4. Deduplicate rooms. Equivalent room types from WithinEarth are collapsed with peer supplier rooms into a canonical room ID.
5. Expose. WithinEarth content is reachable through one Vervotech REST endpoint, mixed with the rest of your supplier inventory.

Example WithinEarth response via Vervotech

Vervotech returns WithinEarth properties enriched with canonical IDs that match the same property as served by peer suppliers.

GET /v3/hotels?supplier=withinearth&country=ma
Authorization: Bearer YOUR_VERVOTECH_KEY

200 OK
{
  "supplier": "WithinEarth",
  "hotels": [
    {
      "vervotech_id": "vt_8f3a91...",
      "withinearth_id": "SUP_REF_12345",
      "name": "Example Hotel Wit",
      "address": "...",
      "geo": { "lat": ..., "lng": ... },
      "rooms": [ { "vervotech_room_id": "vrm_...", "withinearth_room_id": "RM_77" } ]
    }
  ]
}

Schema is illustrative. See the Hotel Mapping API documentation for the full spec.

Vervotech-mapped WithinEarth vs direct WithinEarth integration

Typical WithinEarth use cases

• OTAs and metasearch: blend WithinEarth rates with peer suppliers behind a single property listing, with no duplicates and no schema drift.
• Travel agencies and TMCs: route bookings to WithinEarth when its rate wins, fall back to alternates when it does not, all under one mapped catalog.
• Corporate travel: normalize WithinEarth content into one travel-policy view across regions and brands.
• Post-booking margin capture: watch WithinEarth and peer rates after the original booking and rebook automatically via Vervotech Profit Maximizer when a cheaper rate appears.

Related Vervotech capabilities

• Hotel Mapping API99.998% accuracy at 3M+ properties
• Room Mapping APICanonical room IDs across suppliers
• Profit MaximizerPost-booking margin capture across WithinEarth and peers
• All 153+ suppliersBrowse the full supplier network