3 Langkah Implementasi Pencarian Web xAI Grok API: Panduan Lengkap x_search dan web_search

Catatan Penulis: Memperkenalkan secara mendetail fitur pencarian web terbaru dari xAI Grok API, termasuk metode konfigurasi lengkap dan contoh kode untuk x_search (pencarian konten platform X) dan web_search (pencarian halaman web).

Banyak pengembang yang bertanya-tanya saat menggunakan xAI Grok API: Bagaimana cara menerapkan pencarian web di Grok API? API Live Search yang disediakan xAI sebelumnya kini telah dinonaktifkan, dan sekarang pihak resmi telah meluncurkan fitur pemanggilan alat Tools yang lebih kuat, yang mewujudkan kemampuan pencarian web melalui dua alat sisi server: x_search dan web_search.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai metode lengkap penggunaan xAI Grok API untuk pencarian konten platform X dan pencarian halaman web, sehingga aplikasi AI Anda dapat memperoleh informasi real-time.

Poin Inti Pencarian Web xAI Grok API

Penjelasan Detail Poin Pencarian Web xAI Grok API

Jadwal Penghentian Live Search API: Pihak resmi xAI telah mengumumkan bahwa Live Search API yang lama (dikonfigurasi melalui search_parameters) akan resmi dihentikan pada 12 Januari 2026. Pada saat itu, permintaan akan mengembalikan kode status 410 Gone. Pengembang perlu segera bermigrasi ke Agent Tools API yang baru untuk memastikan kelangsungan layanan.

Keunggulan Inti Arsitektur Baru: Pemanggilan alat Tools yang baru mengadopsi mode eksekusi otonom di sisi server. Saat Anda menyediakan alat x_search atau web_search dalam permintaan, server xAI akan secara otomatis mengatur siklus penalaran cerdas—model akan menganalisis pertanyaan secara mandiri, memulai pencarian, menganalisis hasil, melakukan kueri tambahan jika perlu, dan akhirnya mengembalikan jawaban yang komprehensif. Metode Agentic Search (pencarian agen) ini jauh lebih cerdas dan menyeluruh daripada pencarian sederhana tradisional.

Panduan Cepat Pencarian Web xAI Grok API

Contoh Sederhana

Berikut adalah contoh paling sederhana untuk mencari konten di platform X menggunakan x_search:

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast",
    "input": [
      {
        "role": "user",
        "content": "What is the current status of xAI?"
      }
    ],
    "tools": [
      {
        "type": "x_search"
      }
    ]
  }'

import requests
import os

def grok_x_search(query: str, allowed_handles: list = None) -> dict:
    """
    Menggunakan alat x_search dari xAI Grok API untuk mencari konten di platform X

    Args:
        query: Konten kueri pencarian
        allowed_handles: Opsional, daftar username X yang dibatasi untuk pencarian (maksimal 10)

    Returns:
        Hasil respons API
    """
    url = "https://api.x.ai/v1/responses"
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {os.environ.get('XAI_API_KEY')}"
    }

    # Membangun konfigurasi alat x_search
    x_search_tool = {"type": "x_search"}
    if allowed_handles:
        x_search_tool["allowed_x_handles"] = allowed_handles

    payload = {
        "model": "grok-4-1-fast",
        "input": [
            {"role": "user", "content": query}
        ],
        "tools": [x_search_tool]
    }

    response = requests.post(url, headers=headers, json=payload)
    return response.json()

# Contoh penggunaan: Mencari tweet dari pengguna tertentu
result = grok_x_search(
    query="What are the latest announcements about Grok?",
    allowed_handles=["elonmusk", "xaboratory"]
)
print(result)

Saran: Jika Anda perlu menguji kemampuan pencarian web dari berbagai model AI secara bersamaan, Anda dapat menggunakan antarmuka API terpadu melalui APIYI apiyi.com. Platform ini mendukung model-model populer seperti xAI Grok, OpenAI, dan Claude, sehingga memudahkan Anda untuk membandingkan hasil pencarian dari berbagai model dengan cepat.

Penjelasan Detail Alat x_search xAI Grok API

x_search adalah alat yang dirancang khusus untuk mencari konten di platform X (sebelumnya Twitter), mendukung pencarian kata kunci, pencarian semantik, pencarian pengguna, dan pengambilan topik populer.

Konfigurasi Parameter x_search

Contoh Penggunaan x_search

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast",
    "input": [
      {
        "role": "user",
        "content": "Ringkas pendapat terbaru Elon Musk tentang AI"
      }
    ],
    "tools": [
      {
        "type": "x_search",
        "allowed_x_handles": ["elonmusk"],
        "from_date": "2025-12-01",
        "to_date": "2026-01-23"
      }
    ]
  }'

Tips Penggunaan: Membatasi cakupan pencarian menggunakan allowed_x_handles dapat meningkatkan relevansi dan akurasi hasil pencarian, sangat cocok untuk memantau dinamika pakar industri tertentu atau akun resmi organisasi.

Penjelasan Detail Alat web_search API Grok xAI

Alat web_search dapat mencari di seluruh internet dan menelusuri konten web secara otomatis, menjadikannya alat yang ampuh untuk mendapatkan informasi online secara real-time.

Konfigurasi Parameter web_search

Contoh Penggunaan web_search

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast",
    "input": [
      {
        "role": "user",
        "content": "What are the latest features of GPT-4o?"
      }
    ],
    "tools": [
      {
        "type": "web_search",
        "allowed_domains": ["openai.com", "techcrunch.com"]
      }
    ]
  }'

Saran Skenario: Saat Anda perlu mendapatkan informasi teknis yang otoritatif, gunakan allowed_domains untuk membatasi pencarian ke situs dokumentasi resmi guna memastikan keakuratan informasi.

Perbandingan Solusi Pencarian Online API Grok xAI

Catatan Perbandingan: Kedua alat dapat digunakan secara bersamaan, server xAI akan secara otomatis memilih alat yang sesuai untuk pencarian berdasarkan sifat pertanyaan. Melalui APIYI (apiyi.com), Anda dapat dengan mudah menguji efektivitas berbagai strategi pencarian.

Sitasi dan Sumber Pencarian Web xAI Grok API

Setelah menggunakan pencarian web, API akan mengembalikan semua informasi sumber yang dikunjungi selama proses pencarian. Ada dua mode sitasi:

Format Pengembalian Sitasi

# Contoh permintaan untuk mengaktifkan sitasi inline
payload = {
    "model": "grok-4-1-fast",
    "input": [{"role": "user", "content": "Update terbaru tentang perusahaan xAI"}],
    "tools": [{"type": "x_search"}, {"type": "web_search"}],
    "inline_citations": True  # Aktifkan sitasi inline
}

Catatan: Setelah mengaktifkan sitasi inline, model akan memutuskan secara mandiri berdasarkan konteks apakah akan menambahkan sitasi dalam jawaban; tidak semua jawaban akan menyertakan sitasi inline.

Pertanyaan Umum (FAQ)

Ringkasan

Poin-poin inti dari pencarian web xAI Grok API:

1. Migrasi Segera: Live Search API akan dihentikan pada 12 Januari 2026, segera beralih ke metode pemanggilan Tools.
2. Kombinasi Dua Alat: x_search cocok untuk konten media sosial, sementara web_search cocok untuk informasi web secara umum; keduanya dapat digunakan secara bersamaan.
3. Penalaran Cerdas: Arsitektur baru menggunakan mode Agentic Search, di mana model secara otomatis melakukan pencarian dan analisis beberapa putaran secara mandiri.

Fitur pencarian web Grok API dari xAI memiliki keunggulan unik dalam mengakses konten real-time di platform X, sehingga sangat cocok untuk skenario aplikasi yang perlu melacak dinamika media sosial.

Direkomendasikan untuk mencoba langsung melalui APIYI apiyi.com guna memvalidasi hasilnya dengan cepat. Platform ini menyediakan kuota gratis dan antarmuka terpadu untuk berbagai model, memudahkan Anda membandingkan kemampuan pencarian web antara xAI Grok dengan model lainnya.

📚 Referensi

⚠️ Catatan Format Tautan: Semua tautan luar menggunakan format Nama Materi: domain.com agar mudah disalin namun tidak dapat diklik langsung, guna menghindari penurunan bobot SEO.

1. Dokumentasi Resmi xAI Search Tools: Penjelasan parameter alat pencarian dan contoh yang lengkap

   • Tautan: docs.x.ai/docs/guides/tools/search-tools
   • Keterangan: Dokumentasi resmi yang otoritatif, mencakup spesifikasi API terbaru.

2. xAI Tools Overview: Gambaran umum sistem pemanggilan alat

   • Tautan: docs.x.ai/docs/guides/tools/overview
   • Keterangan: Memahami arsitektur keseluruhan dari alat sisi server xAI.

3. Panduan Migrasi xAI Live Search: Pengumuman penghentian dan instruksi migrasi

   • Tautan: docs.x.ai/docs/guides/live-search
   • Keterangan: Memahami jadwal penghentian dan jalur migrasi.

Penulis: Tim Teknis
Diskusi Teknis: Silakan berdiskusi di kolom komentar. Untuk informasi lebih lanjut, Anda bisa mengunjungi komunitas teknis APIYI apiyi.com.