# ค้นหาผู้ใช้ตามคีย์เวิร์ด

**API:** Data API

**Endpoint:** `GET /v1/beta/twitter/user/search`

**Tags:** Twitter / X

ค้นหาผู้ใช้สาธารณะโดยใช้ query โครงสัญญานี้ไม่ได้ประกาศอินพุตเคอร์เซอร์สำหรับการแบ่งหน้า

### ข้อมูลอ้างอิงราคา

- การวัดปริมาณการใช้งาน: จำนวนผลลัพธ์ที่คิดตามการวัด
- ค่าประมาณคำขออ้างอิง: USD 0.0036
- ต้นทุนขั้นต่ำ: USD 0.00015
- ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว
- ต้นทุนพื้นฐานไม่ได้กำหนดราคาสุดท้ายของลูกค้า รวมถึงกรณีที่เป็นศูนย์

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `query` | query | no | string |  |

## Responses

### 200 — การตอบกลับสำเร็จ

Headers:
- `X-Request-Id` (string) — ตัวระบุคำขอที่ต้องระบุเมื่อติดต่อฝ่ายสนับสนุนของ Felo

**application/json**

Schema: `Response078307E096De_SearchUserResponse` (`#/components/schemas/Response078307E096De_SearchUserResponse`)

### 400 — ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ

### 401 — จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง

### 402 — ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน

### 403 — บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้

### 429 — ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว

### 502 — บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้

### 503 — API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว

### 504 — บริการหมดเวลาระหว่างประมวลผลคำขอ

### default — การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response078307E096De_SearchUserResponse

`#/components/schemas/Response078307E096De_SearchUserResponse`

```json
{
  "type": "object",
  "properties": {
    "users": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Response078307E096De_User"
      }
    },
    "has_next_page": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "msg": {
      "type": "string"
    }
  }
}
```

### Response078307E096De_User

`#/components/schemas/Response078307E096De_User`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "userName": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "isBlueVerified": {
      "type": "boolean"
    },
    "verifiedType": {
      "type": "string"
    },
    "profilePicture": {
      "type": "string"
    },
    "coverPicture": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "followers": {
      "type": "integer"
    },
    "following": {
      "type": "integer"
    },
    "canDm": {
      "type": "boolean"
    },
    "createdAt": {
      "type": "string"
    },
    "favouritesCount": {
      "type": "integer"
    },
    "hasCustomTimelines": {
      "type": "boolean"
    },
    "isTranslator": {
      "type": "boolean"
    },
    "mediaCount": {
      "type": "integer"
    },
    "statusesCount": {
      "type": "integer"
    },
    "withheldInCountries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "possiblySensitive": {
      "type": "boolean"
    },
    "pinnedTweetIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "isAutomated": {
      "type": "boolean"
    },
    "automatedBy": {
      "type": "string"
    },
    "unavailable": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "unavailableReason": {
      "type": "string"
    }
  }
}
```
