# Agoda

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/agoda` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/agoda |

## Description

Leverage the Agoda API to extract real-time hotel prices, ratings, and reviews for comprehensive market analysis.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/agoda' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "meta": {
    "query": "Singapore",
    "page_number": 1,
    "total_pages": 100,
    "total_results": 200,
    "results_per_page": 2
  },
  "hotel_list": [
    {
      "url": "https://www.agoda.com/hotel-jen-orchardgateway.htm",
      "name": "Hotel Jen Orchardgateway",
      "price": "235",
      "rating": "8.8",
      "address": "277 Orchard Rd, Orchard, 238858 Singapore",
      "currency": "USD",
      "review_count": "1234"
    },
    {
      "url": "https://www.agoda.com/marina-bay-sands.htm",
      "name": "Marina Bay Sands",
      "price": "489",
      "rating": "9.2",
      "address": "10 Bayfront Ave, Marina Bay, 018956 Singapore",
      "currency": "USD",
      "review_count": "7890"
    }
  ]
}
```

## Documentation

## Overview
Leverage the Agoda API to extract real-time hotel prices, ratings, and reviews for comprehensive market analysis.

## Quickstart
```
GET https://api.piloterr.com/v2/agoda?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Agoda data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Agoda without maintaining scrapers
- Power internal dashboards and workflow automations with live Agoda data