Name: Thailand Lottery – Get Real-Time Results | Free · $4/mo | API.market
Brand: lottery
SKU: api-lottery-lottery-api
Availability: InStock
Author: API Market

Thiti Yamsung

# 🎰 Thailand Lottery Result API

The Thailand Lottery Result API is a RESTful service that provides access to historical and current Thailand Government Lottery results. This API enables developers to easily retrieve lottery data for a variety of applications, including statistical analysis, lottery number checking, and informational dashboards. Access accurate and up-to-date lottery results, all in a structured JSON format.

## 🎰 API ตรวจสอบผลสลากกินแบ่งรัฐบาล

API สําหรับดึงข้อมูลผลการออกรางวัลสลากกินแบ่งรัฐบาล ข้อมูลตั้งแต่อดีต จนถึงงวดปัจจุบัน อัพเดททันทีหลังจากผลสลากออกอย่างเป็นทางการ

## ✨ ฟีเจอร์
- 🎯 **ดึงผลรางวัลล่าสุด** - ตรวจสอบผลรางวัลงวดล่าสุด
- 📅 **ดึงผลรางวัลตามวันที่** - ค้นหาผลรางวัลจากวันที่ต้องการ (YYYY-MM-DD)
- 🔍 **ตรวจเลขท้าย** - ตรวจสอบหมายเลขพร้อมกันได้ถึง 100 เลข
- 📊 **ข้อมูลที่จัดเรียบร้อย** - ข้อมูล JSON ที่จัดโครงสร้างดี พร้อมรายละเอียดรางวัล


## ✨ Features

- 🎯 **Get Latest Results** - Fetch the most recent lottery drawing results
- 📅 **Get Results by Date** - Retrieve results from specific dates (YYYY-MM-DD)
- 🔍 **Check Numbers** - Check multiple lottery numbers at once (up to 100 numbers)
- 📊 **Structured Response** - Well-organized JSON responses with prize details


## Use Cases

*   **Financial Analysis & Gambling Platforms:** Integrate lottery results into financial analysis platforms to provide users with insights on past winning numbers and probabilities. Useful for gambling websites and apps focusing on the Thailand lottery market.
*   **Informational Kiosks & News Aggregators:** Power informational kiosks or news aggregators with the latest lottery results. Keep the public informed by displaying results in real-time at public spaces.
*   **Mobile Lottery Apps:** Build mobile apps that allow users to check their lottery numbers quickly and easily. Send notifications for winning numbers and offer features like historical data analysis.
*   **Retail Lottery Outlets:** Provide lottery retailers with a service that quickly checks large amounts of user lottery numbers against historical and current data. This can be integrated into a POS system or as a standalone solution.
*   **Academic Research:** Academics studying gambling behavior or statistical trends in lottery outcomes can use this API to gather large datasets.

## API Documentation

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/magicapi/lottery-api`

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### 1. Get Latest Results

**Endpoint:** `GET /api/v1/magicapi/lottery-api/api/v1/latest`

**Description:** Retrieves the latest Thailand lottery results.

**Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/lottery-api/api/v1/latest" \
-H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response (200 OK):**

```json
{
  "success": true,
  "data": {
    "resultDate": "2024-07-01",
    "results": [
      {
        "fieldName": "firstPrize",
        "nameTh": "รางวัลที่ 1",
        "nameEn": "First Prize",
        "price": 6000000,
        "numbers": [
          {
            "value": "123456",
            "round": 1
          }
        ]
      },
      {
        "fieldName": "lastTwoDigits",
        "nameTh": "เลขท้าย 2 ตัว",
        "nameEn": "Last Two Digits",
        "price": 2000,
        "numbers": [
          {
            "value": "78",
            "round": 1
          }
        ]
      }
    ]
  }
}
```

#### 2. Get Results by Date

**Endpoint:** `GET /api/v1/magicapi/lottery-api/api/v1/result/{date}`

**Description:** Retrieves Thailand lottery results for a specific date.

**Path Parameter:**

*   `date` (string, required): The date for which to retrieve lottery results, in YYYY-MM-DD format.

**Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/lottery-api/api/v1/result/2024-06-16" \
-H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response (200 OK):**

```json
{
  "success": true,
  "data": {
    "resultDate": "2024-06-16",
    "results": [
      {
        "fieldName": "firstPrize",
        "nameTh": "รางวัลที่ 1",
        "nameEn": "First Prize",
        "price": 6000000,
        "numbers": [
          {
            "value": "654321",
            "round": 1
          }
        ]
      },
      {
        "fieldName": "lastTwoDigits",
        "nameTh": "เลขท้าย 2 ตัว",
        "nameEn": "Last Two Digits",
        "price": 2000,
        "numbers": [
          {
            "value": "90",
            "round": 1
          }
        ]
      }
    ]
  }
}
```

**Error Response (404 Not Found):**

```json
{
  "success": false,
  "message": "No lottery results found for the given date"
}
```

#### 3. Check Numbers

**Endpoint:** `POST /api/v1/magicapi/lottery-api/api/v1/check`

**Description:** Checks if the provided lottery numbers have won any prizes for a specific date.

**Request Body:**

```json
{
  "numbers": ["123456", "654321", "112233"],
  "date": "2024-06-16"
}
```

**Request:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/lottery-api/api/v1/check" \
-H "Content-Type: application/json" \
-H "x-api-market-key: YOUR_API_MARKET_KEY" \
-d '{
  "numbers": ["123456", "654321", "112233"],
  "date": "2024-06-16"
}'
```

**Response (200 OK):**

```json
{
  "success": true,
  "data": {
    "resultDate": "2024-06-16",
    "results": [
      {
        "number": "123456",
        "won": false,
        "totalAmount": 0,
        "prizes": []
      },
      {
        "number": "654321",
        "won": true,
        "totalAmount": 6000000,
        "prizes": [
          {
            "fieldName": "firstPrize",
            "prizeNameTh": "รางวัลที่ 1",
            "prizeNameEn": "First Prize",
            "prize": "654321",
            "amount": 6000000,
            "matchedNumber": "654321",
            "round": 1
          }
        ]
      },
      {
        "number": "112233",
        "won": false,
        "totalAmount": 0,
        "prizes": []
      }
    ]
  }
  
}
```

**Error Response (400 Bad Request):**

```json
{
  "success": false,
  "message": "Invalid date format"
}
```

**Error Response (404 Not Found):**

```json
{
  "success": false,
  "message": "No lottery results found for the given date"
}
```

## Status Codes

*   `200 OK`: Request successful.
*   `400 Bad Request`: Invalid input parameters or malformed request. This might be due to incorrect date format or invalid lottery number format.
*   `401 Unauthorized`: Missing or invalid API key. Double-check your API key and ensure it's included in the `x-api-market-key` header.
*   `404 Not Found`: Resource not found. Typically occurs when no lottery results are available for the specified date.
*   `500 Internal Server Error`: Server-side error. If this occurs, please try again later. If the problem persists, contact support.
*   `503 Service Unavailable`: Service temporarily unavailable. This could be due to maintenance or high load. Try again after some time.

## Rate Limits

Please contact API.market support for rate limit details.  If you exceed the rate limit, you will receive a `429 Too Many Requests` error. Implement retry logic with exponential backoff to handle rate limiting gracefully.

## Error Handling

The API returns error responses in JSON format, including a `success` flag set to `false` and a descriptive `message`.  Always check the `success` flag and handle errors appropriately.

**Example Error Response:**

```json
{
  "success": false,
  "message": "Invalid lottery number format"
}
```

**Common Errors and Resolutions:**

*   **Invalid Date Format:** Ensure the date is in YYYY-MM-DD format.
*   **Invalid Lottery Number:** Ensure lottery numbers are six-digit strings.
*   **API Key Missing or Invalid:** Double-check your API key.
*   **Rate Limit Exceeded:** Implement retry logic and consider upgrading your pricing tier if needed.

## Pricing

*   1 API unit equals one lottery result processed.  This applies to both the "Get Results by Date" and the "Check Numbers" endpoints.
*   GET requests to check prediction status (GET /api/v1/magicapi/lottery-api/predictions/{id}) are not applicable for this API as it does not use asynchronous processing.
*   Different pricing tiers are available based on usage volume. Please refer to the API.market website for pricing details.

## Implementation Guide

This API is straightforward and does not require asynchronous processing like the guidelines indicate, but examples are still provided.

### Example Code

#### Python

```python
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/lottery-api"

def get_latest_results():
    headers = {"x-api-market-key": API_KEY}
    response = requests.get(f"{BASE_URL}/api/v1/latest", headers=headers)
    response.raise_for_status()  # Raise HTTPError for bad responses (4xx or 5xx)
    return response.json()

def get_results_by_date(date):
    headers = {"x-api-market-key": API_KEY}
    response = requests.get(f"{BASE_URL}/api/v1/result/{date}", headers=headers)
    response.raise_for_status()
    return response.json()

def check_numbers(numbers, date):
    headers = {
        "Content-Type": "application/json",
        "x-api-market-key": API_KEY
    }
    data = {"numbers": numbers, "date": date}
    response = requests.post(f"{BASE_URL}/api/v1/check", headers=headers, json=data)
    response.raise_for_status()
    return response.json()

# Example Usage:
try:
    latest_results = get_latest_results()
    print("Latest Results:", latest_results)

    results_by_date = get_results_by_date("2024-06-16")
    print("Results by Date:", results_by_date)

    checked_numbers = check_numbers(["123456", "654321"], "2024-06-16")
    print("Checked Numbers:", checked_numbers)

except requests.exceptions.HTTPError as e:
    print(f"HTTP Error: {e}")
except Exception as e:
    print(f"An error occurred: {e}")
```

#### JavaScript

```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/lottery-api";

async function getLatestResults() {
  const response = await fetch(`${baseUrl}/api/v1/latest`, {
    headers: {
      "x-api-market-key": apiKey,
    },
  });
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }
  return await response.json();
}

async function getResultsByDate(date) {
  const response = await fetch(`${baseUrl}/api/v1/result/${date}`, {
    headers: {
      "x-api-market-key": apiKey,
    },
  });
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }
  return await response.json();
}

async function checkNumbers(numbers, date) {
  const response = await fetch(`${baseUrl}/api/v1/check`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-market-key": apiKey,
    },
    body: JSON.stringify({ numbers, date }),
  });
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }
  return await response.json();
}

// Example Usage:
(async () => {
  try {
    const latestResults = await getLatestResults();
    console.log("Latest Results:", latestResults);

    const resultsByDate = await getResultsByDate("2024-06-16");
    console.log("Results by Date:", resultsByDate);

    const checkedNumbers = await checkNumbers(["123456", "654321"], "2024-06-16");
    console.log("Checked Numbers:", checkedNumbers);

  } catch (error) {
    console.error("An error occurred:", error);
  }
})();
```

#### cURL

```bash
# Get Latest Results
curl -X GET "https://prod.api.market/api/v1/magicapi/lottery-api/api/v1/latest" \
-H "x-api-market-key: YOUR_API_MARKET_KEY"

# Get Results by Date
curl -X GET "https://prod.api.market/api/v1/magicapi/lottery-api/api/v1/result/2024-06-16" \
-H "x-api-market-key: YOUR_API_MARKET_KEY"

# Check Numbers
curl -X POST "https://prod.api.market/api/v1/magicapi/lottery-api/api/v1/check" \
-H "Content-Type: application/json" \
-H "x-api-market-key: YOUR_API_MARKET_KEY" \
-d '{
  "numbers": ["123456", "654321", "112233"],
  "date": "2024-06-16"
}'
```

### Performance Optimization

*   **Cache Results:** If you are repeatedly requesting the same lottery results, consider caching the results on your side to reduce the number of API calls.
*   **Limit Number Checking:** If checking a large number of lottery numbers, batch your requests to stay within the API's limits.

## FAQ

**Q: What date format should I use?**

A: The date format should be YYYY-MM-DD.

**Q: How many lottery numbers can I check at once?**

A: You can check up to 100 lottery numbers in a single request.

**Q: What happens if no results are found for a given date?**

A: The API will return a 404 Not Found error with a message indicating that no lottery results were found.

**Q: What if I exceed the rate limit?**

A: The API will return a 429 Too Many Requests error. You should implement retry logic with exponential backoff. Contact API.market support for rate limit details.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello[at]api.market.


Get fast, accurate Thailand Government Lottery results. Check up to 100 numbers. Free 10 calls/mo, from $3.5/mo. Start free on API.market.

Thailand Lottery – Get Real-Time Results | Free · $4/mo | API.market