{"info":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","description":"

The StructurrAI Hotel Mapping provides travel companies, OTAs, and hotel aggregators with a robust framework to streamline hotel inventories. By utilizing advanced AI-driven matching algorithms, the platform identifies and eliminates duplicate listings across multiple supplier feeds, generating a unified and deduplicated hotel catalog.

Core Inventory Benefits

High Accuracy Precisely identifies duplicate hotels across fragmented supplier data using AI-driven matching.
\n
Faster Turnaround (TAT) Enables quick, near real-time mapping and reconciliation of large inventories.
\n
Language Agnostic Accurately maps hotels across different languages, spellings, and formats.
\n
Better Coverage Maximizes the percentage of hotels successfully mapped across multiple suppliers.
\n
Incremental Sync Ready Supports seamless updates through added, updated, and deleted mappings.
\n

API Structure

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Module	Purpose
Country Master	Provides a standardized list of countries along with StructurrAI country codes. Ensures all systems use the same country identifiers.
City Master	Provides standardized city names and StructurrAI city codes for each country. Helps maintain consistency in city-level mapping.
Hotel Search	Retrieve standardized hotel clusters and mapped supplier records.
Hotel Static Content	A single endpoint providing complete standardized hotel content including name, address, description, lat/long, hero image, and additional images.
Added Mappings	Returns all newly added hotel clusters or mappings after a given timestamp.
Deleted Mappings	Returns hotel clusters or mappings that have been removed or invalidated after a given timestamp.
Modified Mappings	Returns hotel clusters where existing mappings or details have been modified after a given timestamp.

FAQs

What is the recommended integration flow? Start with Country and City Master, then use Hotel Search for initial mapping, followed by Added, Updated, and Deleted APIs for ongoing sync.
\n
How do I keep my inventory updated efficiently? Use incremental APIs with timestamps to fetch only changes instead of reprocessing the entire dataset.
\n
What is the correct order for incremental APIs? Added Mappings -> Updated Mappings -> Deleted Mappings. This ensures proper data consistency.
\n
When should I use the Static Content API? After mapping, to enrich hotels with standardized descriptions, images, and metadata.
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"46998739","collectionId":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","publishedId":"2sBXihpXmG","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-17T18:55:32.000Z"},"item":[{"name":"country master","item":[{"name":"country codes","id":"d433eec2-96f7-4903-bf33-395ce0588a41","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"api-key","value":"cbGinboOtosMTFgM7MZ8oFgqrsFZPuLd","type":"text"}],"url":"https://test.structurrai.com/api/v2/countries","description":"

Fetches the list of countries supported by the StructurrAI Hotel Mapping API. This endpoint can be used to obtain the available countries configured in the system before performing operations that require country-level references.

The Country Master API provides a complete list of countries supported by StructurrAI, each assigned a standardized StructurrAI country code.

These country codes serve as a reference for fetching city codes belonging to a particular country, ensuring consistency across all mapping operations.

\n","_postman_id":"515eb220-53f5-49e6-b3a2-3733dfa89fa0","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}}},{"name":"city master","item":[{"name":"city master","id":"c639ea5d-54a8-40b6-81a0-23072293992e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"api-key","value":"cbGinboOtosMTFgM7MZ8oFgqrsFZPuLd","type":"text"}],"url":"https://test.structurrai.com/api/v2/cities?country_id=SI-IN","description":"

Returns the list of cities supported by the StructurrAI Hotel Mapping platform for the specified country_id.

Standardized country identifier used to retrieve cities associated with the specified country.

\n","type":"text/plain"},"key":"country_id","value":"SI-IN"}],"variable":[]}},"response":[{"id":"d39e2799-3463-4a8b-81ae-32bf8daa6d69","name":"city master","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://test.structurrai.com/api/v2/cities?country_id=SI-IN","protocol":"https","host":["test","structurrai","com"],"path":["api","v2","cities"],"query":[{"key":"country_id","value":"SI-IN","description":"Standardized country code from country master api"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": \"\",\n \"message\": \"\",\n \"data\":{\n \"cities\": [\n {\n \"city_code\": \"\",\n \"city\": \"\",\n \"country_code\": \"\",\n \"country_name\": \"\"\n }\n ],\n \"country_id\": \"\",\n \"country_name\": \"\"\n },\n \"errors\":[]\n}"}],"_postman_id":"c639ea5d-54a8-40b6-81a0-23072293992e"}],"id":"9fa2a532-7fcf-4e70-9598-27c4d9f532e2","description":"

The City Master API returns the list of cities supported by the StructurrAI Hotel Mapping platform for a given country.

Each city is associated with a standardized city code, which is used across StructurrAI APIs to maintain consistent geographic references.

These city codes are typically used by downstream services such as the Hotel Search API to retrieve hotels mapped to a specific city.

\n","_postman_id":"9fa2a532-7fcf-4e70-9598-27c4d9f532e2","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}}},{"name":"hotelsearch","item":[{"name":"Search hotels by city codes","id":"e662c60d-735c-4003-be42-f28ec0d47719","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"api-key","value":"cbGinboOtosMTFgM7MZ8oFgqrsFZPuLd","type":"text"}],"body":{"mode":"raw","raw":"{\n \"standardized_city_codes\": [\n \"STR-IN-0607\"\n ]\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://test.structurrai.com/api/v2/hotelsearch","description":"

Searches for hotels in the specified cities using city codes.

The request accepts an array of city codes and returns hotel clusters along with provider details mapped to those cities.

A maximum of 25 cities can be included in a single request.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}},"urlObject":{"path":["api","v2","hotelsearch"],"host":["https://test.structurrai.com"],"query":[],"variable":[]}},"response":[{"id":"2055676a-7018-4aa7-92fc-c62eb75a1ee2","name":"Search hotels by city codes","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"standardized_city_codes\": [\n \"\"\n ]\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://test.structurrai.com/api/v2/hotelsearch"},"_postman_previewlanguage":"Text","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"success\": true,\r\n \"message\": \"\",\r\n \"data\": [\r\n {\r\n \"standardized_hotel_id\": \"\",\r\n \"standardized_hotel_name\": \"\",\r\n \"standardized_address\": \"\",\r\n \"standardized_city\": \"\",\r\n \"latitude\": \"\",\r\n \"longitude\": \"\",\r\n \"last_updated\": \"\",\r\n \"standardized_city_code\": \"\",\r\n \"standardized_country_code\": \"\",\r\n \"provider_details\": [\r\n {\r\n \"supplier_name\": \"\",\r\n \"supplier_id\": \"\",\r\n \"hotel_name\": \"\",\r\n \"address\": \"\",\r\n \"supplier_city_code\": \"\",\r\n \"supplier_city\": \"\",\r\n \"supplier_country_code\": \"\"\r\n }\r\n ]\r\n ],\r\n \"errors\": null\r\n}\r\n"}],"_postman_id":"e662c60d-735c-4003-be42-f28ec0d47719"}],"id":"81261797-7852-4099-bf99-33d3e2c0a5d6","description":"

The Hotel Search API serves as the primary endpoint of the StructurrAI Hotel Mapping platform, designed to deliver comprehensive and deduplicated hotel data clusters. By leveraging advanced AI algorithms, the endpoint consolidates hotel information from multiple suppliers into a single, unified record.

For each hotel cluster, the API returns a unique StructurrAI hotel code, standardized hotel details including name, address, geographical coordinates (latitude and longitude), and the last updated timestamp, along with the complete set of mapped supplier records associated with that hotel.

This endpoint accepts StructurrAI city codes as input, ensuring that travel companies can retrieve mapped hotel listings for the given city.

\n","_postman_id":"81261797-7852-4099-bf99-33d3e2c0a5d6","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}}},{"name":"addedhotels","item":[{"name":"Get newly added hotels","id":"030d9c29-ca34-4680-ab2f-c6b648693f07","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://test.structurrai.com/api/v1/addedhotels?last_updated_date=2025-09-24&page=1&offset=50","description":"

Returns hotels that were added after the specified last_updated_date.

Date used to fetch hotels added after the specified date. Format: YYYY-MM-DD.

\n","type":"text/plain"},"key":"last_updated_date","value":"2025-09-24"},{"key":"page","value":"1"},{"key":"offset","value":"50"}],"variable":[]}},"response":[{"id":"65bf7de3-632e-467f-bbfd-5cf31dcdadcb","name":"Information about newly added hotels","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"api-key","value":"","description":"Added as a part of security scheme: apikey"}],"url":{"raw":"https://test.structurrai.com/api/v1/addedhotels?last_updated_date=YYYY-MM-DD&page=1&offset=50","protocol":"https","host":["test","structurrai","com"],"path":["api","v1","addedhotels"],"query":[{"key":"last_updated_date","value":"YYYY-MM-DD"},{"key":"page","value":"1"},{"key":"offset","value":"50"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"\",\n \"data\": {\n \"last_updated_date\": \"\",\n \"mapped_hotels\": [\n {\n \"standardized_hotel_id\": \"\",\n \"standardized_hotel_name\": \"\",\n \"standardized_address\": \"\",\n \"standardized_city\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"last_updated\": \"\",\n \"standardized_city_code\": \"\",\n \"standardized_country_code\": \"\",\n \"provider_details\": [\n {\n \"supplier_name\": \"\",\n \"supplier_id\": \"\",\n \"hotel_name\": \"\",\n \"address\": \"\",\n \"supplier_city_code\": \"\",\n \"supplier_city\": \"\",\n \"supplier_country_code\": \"\"\n }\n ]\n }\n ]\n },\n \"errors\": null\n}"}],"_postman_id":"030d9c29-ca34-4680-ab2f-c6b648693f07"}],"id":"da375dce-03c9-4bf7-bc07-afb45d93c78a","description":"

The Added Hotels API allows travel companies to retrieve hotels that have been newly added to the StructurrAI mapping system since their last database update.

By providing the last_updated_date parameter in the request, the API returns hotels introduced after that timestamp along with their creation details. This enables systems to efficiently sync only new records and keep their hotel inventory continuously up to date.

\n
Note: This API will be functional only once the system is in production and integrated with the client's system to share the periodic updates with them.
\n

\n","_postman_id":"da375dce-03c9-4bf7-bc07-afb45d93c78a","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}}},{"name":"deletedhotels","item":[{"name":"Get deleted hotels","id":"d954612b-2314-4f5f-ba12-5e568fc456b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://test.structurrai.com/api/v1/deletedhotels?last_updated_date=2025-09-24&page=1&offset=50","description":"

Returns hotel mappings that have been deleted after the specified last_updated_date.

Date used to fetch hotels that were deleted after the specified date. The value must be provided in YYYY-MM-DD format.

The Deleted Hotels API enables travel companies to identify hotel mappings that have been removed from the StructurrAI mapping system since their last database update.

By providing the last_updated_date parameter in the request, the API returns hotel records that were deleted after the specified timestamp. This allows systems to synchronize their data by removing obsolete mappings and maintaining an accurate, up-to-date hotel inventory.

\n
Note: This API will be functional only once the system is in production and integrated with the client's system to share the periodic updates with them.
\n

\n","_postman_id":"293a243f-d642-46c1-828a-1e924f3aca3f","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}}},{"name":"updatedhotels","item":[{"name":"Get updated hotels","id":"ae68face-75b8-4e1d-8b89-a707e0a25227","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"api-key","value":"cbGinboOtosMTFgM7MZ8oFgqrsFZPuLd","type":"text"}],"url":"https://test.structurrai.com/api/v1/updatedhotels?last_updated_date=2025-09-24","description":"

Returns hotel mappings that were updated after the specified last_updated_date.

Date used to fetch hotels that were updated after the specified date. The value must be provided in YYYY-MM-DD format.

\n","type":"text/plain"},"key":"last_updated_date","value":"2025-09-24"}],"variable":[]}},"response":[{"id":"54a6067a-eb12-4ad1-8c6b-0310a9fd4c5e","name":"Information about updated hotels","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"api-key","value":"","description":"Added as a part of security scheme: apikey"}],"url":{"raw":"https://test.structurrai.com/api/v1/updatedhotels?last_updated_date=YYYY-MM-DD&page=1&offset=50","protocol":"https","host":["test","structurrai","com"],"path":["api","v1","updatedhotels"],"query":[{"key":"last_updated_date","value":"YYYY-MM-DD"},{"key":"page","value":"1"},{"key":"offset","value":"50"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"\",\n \"data\": {\n \"last_updated_date\": \"\",\n \"mapped_hotels\": [\n {\n \"standardized_hotel_id\": \"\",\n \"standardized_hotel_name\": \"\",\n \"standardized_address\": \"\",\n \"standardized_city\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"last_updated\": \"\",\n \"standardized_city_code\": \"\",\n \"standardized_country_code\": \"\",\n \"provider_details\": [\n {\n \"supplier_name\": \"\",\n \"supplier_id\": \"\",\n \"hotel_name\": \"\",\n \"address\": \"\",\n \"supplier_city_code\": \"\",\n \"supplier_city\": \"\",\n \"supplier_country_code\": \"\"\n }\n ]\n }\n ]\n },\n \"errors\": null\n}"}],"_postman_id":"ae68face-75b8-4e1d-8b89-a707e0a25227"}],"id":"ef2f18a4-dfd5-4c2b-98a2-b56ddee7f80a","description":"

The Updated Hotels API allows travel companies to retrieve hotel mappings that have been modified in the StructurrAI mapping system since their last database update.

By providing the last_updated_date parameter in the request, the API returns hotel records that were updated after the specified timestamp. This enables systems to synchronize updates such as name corrections, address changes, or other modifications while maintaining an accurate and up-to-date hotel inventory.

\n
Note: This API will be functional only once the system is in production and integrated with the client's system to share the periodic updates with them.
\n

\n","_postman_id":"ef2f18a4-dfd5-4c2b-98a2-b56ddee7f80a","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}}},{"name":"hotel static content","item":[{"name":"Hotel static content by city codes","id":"96eef20f-7e5e-4736-9df3-8f355315b19b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"cbGinboOtosMTFgM7MZ8oFgqrsFZPuLd","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"standardized_city_codes\": [\"STR-IN-0607\"]\r\n}\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://test.structurrai.com/api/v2/hotelstaticdata","description":"

This endpoint allows for a bulk search of hotels within specified cities using City Codes. It returns the fully mapped and standardized hotel clusters with their corresponding provider details.

Constraints

A maximum of 25 cities can be passed in a single request array.
\n
The response includes the standardized_hotel_id which acts as the master key for the hotel cluster.
\n

Body Schema

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`city_id`	String	Yes	A region specific city code.

","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}},"urlObject":{"path":["api","v2","hotelstaticdata"],"host":["https://test.structurrai.com"],"query":[],"variable":[]}},"response":[{"id":"0f99c658-f8e2-478b-a24a-008c7699c2fe","name":"Success - London","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"standardized_city_codes\": [\r\n \"STR-GB-0001\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.structurrai.com/api/v2/hotelstaticdata"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"\",\n \"data\": [\n {\n \"standardized_hotel_id\": \"\",\n \"standardised_hotel_name\": \"\",\n \"standardised_address\": \"\",\n \"city_code\": \"\",\n \"description\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"hero_image_url\": \"\",\n \"image_urls\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"errors\": null\n}"}],"_postman_id":"96eef20f-7e5e-4736-9df3-8f355315b19b"}],"id":"3b7ab869-37f0-4364-85ac-39cd8f56acbd","description":"

This API is designed to serve all the static content requirnments through a single endpoint.

For each hotel cluster, the API returns a unique StructurrAI hotel code, standardized hotel details including name, address, geographical coordinates (latitude and longitude), and image URLs.

This endpoint accepts StructurrAI city codes as input, ensuring that travel companies can retrieve mapped hotel listings for a given city.

Currently, this endpoint will function for Mumbai, Dubai and London.

\n","_postman_id":"3b7ab869-37f0-4364-85ac-39cd8f56acbd","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","id":"e0ab0ed9-e77f-4a65-a7b9-e225f71d07a6","name":"StructurrAI Hotel Mapping","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[]}},"event":[{"listen":"prerequest","script":{"id":"bbb4116d-d733-44b8-88f8-5d30c51bf811","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"bfa1d3d7-3bc9-4d36-9618-c8fd09b875e8","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"api-key","value":""},{"key":"baseUrl","value":"https://test.structurrai.com"}]}