Introduction

StructurrAI Mappings is a comprehensive hotel mapping solution that helps you maintain accurate and up-to-date hotel mappings across multiple providers. Our system processes millions of hotel mappings daily to ensure your inventory stays synchronized.

Key Features

Real-time mapping updates

Support for multiple hotel providers

Automated synchronization

99.9% mapping accuracy

Parameter	StructurrAI	Source 1	Source 2	Source 3
Hotel ID	STR_856A	S1_4475	S2_1374	S3_647
Hotel ID	STR_856B	S1_456	S2_293	S3_527
Name	Rove Dubai	Rove Dubai	Hotel Rove	Rove
Name	The Marriot	Dubai Marriot	Marriot Inn	The Marriot
Address	19 Al Falak St	19 Al Falak Street	Al Falak St 19	19 Al Falak
Location	Central Dubai	Dubai Downtown	Central Dubai	Downtown Area

Getting Started

1. Authentication

Obtain your API key from the dashboard

Authorization: Bearer YOUR_API_KEY

2. Base URL

All API requests should be made to

https://api.structurrai.com/v1

3. Response Format

All responses are returned in JSON format

Content-Type: application/json

Fetch Hotel Count

GET

Retrieve the total count of hotels in the mapping system

API Parameters Reference

Header Parameters

Query Parameters

apikeyRequiredstring

Required. The API key associated with your account.

example: apikey=056ec4c3-be6b-4c36-a4cc-a403ce9592a1

accountIdRequiredstring

Required. The account ID associated with your StructurrAI Mappings account.

example: accountId=DemoAccount

Response Reference

200 OK

MappingCountnumber

Statusboolean

Messagestring

{
  "MappingCount": 100,
  "ApiType": "new",
  "Status": true,
  "Message": "Success",
  "StatusCode": 200
}

403 Forbidden

500 Internal Server Error

Fetch Mappings

GET

This API provides mappings that are newly added or updated in your account after the date specified in the lastUpdatedDateTime parameter of your API request.

API Parameters Reference

Header Parameters

Query Parameters

syncIdOptionalstring

The unique identifier for each content sync run.

example: syncId=123e4567-e89b-12d3-a456-426614174000

apikeyOptionalstring

The API key associated with your account.

example: apikey=056ec4c3-be6b-4c36-a4cc-a403ce9592a1

accountIdOptionalstring

The account ID registered with StructurrAI Mappings.

example: accountId=DemoAccount

Response Reference

200 OK

ResumeKeystring

MappingsArray

Statusboolean

{
  "Mappings": [
    {
      "StructurraiId": "STR_1545",
      "HotelName": "Grand Plaza Hotel",
      "Address": "123 Main Street, New York, NY 10001, USA",
      "Latitude": 40.7128,
      "Longitude": -74.006,
      "Status": "Active",
      "LastUpdated": "2023-06-15T14:30:00Z",
      "ProviderDetail": [
        {
          "ProviderFamily": "HotelBeds",
          "ProviderId": "HBA_67890"
        },
        {
          "ProviderFamily": "TBO",
          "ProviderId": "TBO_088675"
        }
      ]
    }
  ],
  "ResumeKey": "d8e8fca2-dc0f-4a4a-8d1d-934e943a354b",
  "Status": true,
  "Message": "Success",
  "StatusCode": 200
}

Fetch New Mappings

GET

Get new mapping entries added to the system

API Parameters Reference

apikeyRequiredstring

Required. The API key associated with your account for authentication.

accountIdRequiredstring

Required. The account ID associated with your registered account.

syncIdRequiredstring

Required. A unique identifier for each content synchronization cycle.

Fetch Updated Mappings

GET

Retrieve mappings that have been updated since the last sync

API Parameters Reference

apikeyRequiredstring

Required. The API key associated with your account.

lastUpdatedDateTimeRequiredstring

ISO 8601 formatted date-time to fetch updates from.

example: lastUpdatedDateTime=2023-06-01T00:00:00Z

Fetch Deleted Mappings

GET

Retrieve mappings that have been removed from the system

API Parameters Reference

apikeyRequiredstring

Required. The API key associated with your account.

syncIdRequiredstring

Required. The sync cycle identifier.

Fetch Mapping Statistics

GET

Get statistics about your mapping data including total counts and accuracy metrics

API Parameters Reference

apikeyRequiredstring

Required. The API key associated with your account.

accountIdRequiredstring

Required. Your StructurrAI account identifier.

Response Reference

200 OK

{
  "TotalMappings": 1250000,
  "ActiveMappings": 1200000,
  "NewMappingsToday": 5420,
  "UpdatedMappingsToday": 12350,
  "AccuracyRate": 99.9,
  "ProvidersConnected": 15,
  "Status": true,
  "Message": "Success"
}

Code Examples

Integration examples in popular programming languages

Fetch Mappings

curl -X GET "https://api.structurrai.com/v1/mappings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accountId": "YOUR_ACCOUNT_ID", "syncId": "YOUR_SYNC_ID"}'

Python Example

import requests

url = "https://api.structurrai.com/v1/mappings"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
params = {
    "accountId": "YOUR_ACCOUNT_ID",
    "syncId": "YOUR_SYNC_ID"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

for mapping in data["Mappings"]:
    print(f"Hotel: {mapping['HotelName']}")
    print(f"ID: {mapping['StructurraiId']}")

JavaScript/Node.js Example

const fetchMappings = async () => {
  const response = await fetch(
    'https://api.structurrai.com/v1/mappings?' +
    new URLSearchParams({
      accountId: 'YOUR_ACCOUNT_ID',
      syncId: 'YOUR_SYNC_ID'
    }),
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    }
  );

  const data = await response.json();
  console.log('Mappings:', data.Mappings);
};

fetchMappings();

Need Help?

Contact our support team at pankaj@structurrai.com for assistance with API integration or technical questions.

Contact Support