# Ratehawk

{% embed url="<https://youtu.be/WQTuQEwrHjA>" %}

### 📌 Overview

This guide explains how to integrate the **RateHawk API** into your PHPTRAVELS-based travel booking system.

The integration allows you to:

* Search hotels in real-time
* Display hotel content locally (fast loading)
* Process bookings with live pricing
* Manage bookings with PNR confirmation

***

### ⚙️ 1. API Authentication & Setup

**Steps:**

1. Register with RateHawk and get API access
2. Collect the following credentials:
   * API Key
   * Key ID
   * Key Type
3. Go to your admin panel:

```
Modules > Stays > RateHawk
```

4. Enter your API credentials
5. Click **Test API Connection**

✅ Expected Result:

* Search API working
* Booking API working
* Management API working

***

### 🗄️ 2. Database Configuration

To handle large hotel data, a separate database is required.

**Steps:**

1. Create a new database via:
   * CPanel / CloudPanel / Hosting Panel
2. Save credentials:
   * Database Name
   * Username
   * Password
   * Host
3. Add these details in your system settings

✅ This ensures:

* Secure connection
* Better performance
* Scalable data handling

***

### 📥 3. Database Import & Content Setup

RateHawk provides a **large dataset (30GB+)** for hotel content.

**Steps:**

1. Download the database file from RateHawk
2. Rename file to:

```
db.json
```

3. Upload file to:

```
/modules/stays/ratehawk/content
```

4. Go to Admin Panel → Run **Import Tool**

***

#### ⚠️ Important Notes

* Import process can take **12–24+ hours**
* Depends on server performance
* Keep process running (do not stop)
* Recommended: Use VPS or dedicated server

***

### 🔍 4. Search, Pricing & Booking Flow

Once data is imported:

#### 🔎 Hotel Search

* Uses **local database** for:
  * Hotel names
  * Images
  * Descriptions
  * Locations

👉 Result: **Fast loading search results**

***

#### 💰 Pricing & Availability

* Pulled in real-time from RateHawk API

👉 Result: **Accurate live pricing**

***

#### 🛒 Booking Flow

1. User selects hotel
2. System fetches live rates
3. Payment processed (e.g., Stripe)
4. Booking confirmed

✅ Output:

* Booking status: Confirmed
* PNR generated
* Stored in admin panel

***

### 🚀 Best Practices

* Use **high-performance server (8GB+ RAM recommended)**
* Run import via **CLI or background process**
* Enable caching for better speed
* Monitor logs during import

***

### 💡 Need a Ready Solution?

We provide a complete travel booking system with:

* Hotels (RateHawk, Hotelbeds, Agoda)
* Flights (Amadeus, Travelport, Duffel)
* Tours (Viator, Tiqets)
* Cars & Transfers
* B2B + B2C system

👉 Book a free meeting:\
<https://phptravels.com/meeting>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.phptravels.com/modules/stays/ratehawk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.