# Membuat Tugas SERP Google AI Mode

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/ai_mode/task_post`

**Tags:** DataForSEO

Mengantrekan jawaban AI Mode Google untuk kueri, beserta sumber yang dikutipnya di Google, mengembalikan `id` tugas di `tasks[0].id`. Dibungkus dalam envelope DataForSEO: data di `tasks[0].result`, hasil di `tasks[0].status_code` - permintaan yang ditolak tetap mengembalikan HTTP 200. Pasangan live-nya menjawab segera dan lebih sederhana untuk satu kueri; antrekan bila batch akan melebihi satu panggilan alat.

### Referensi harga

- Metering: Biaya respons yang dilaporkan.
- Estimasi referensi per permintaan: USD 0.02.
- Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

## Related links

- [artikel Pusat Bantuan](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [Google Search Help](<https://support.google.com/websearch/answer/16011537?hl=en&co=GENIE.Platform%3DAndroid#>)
- [Harga](<https://dataforseo.com/pricing/serp/google-ai-mode-serp-api>)
- [Pusat Bantuan](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)
- [Kunjungi Pusat Bantuan untuk mempelajari lebih lanjut&gt;&gt;](<https://dataforseo.com/help-center/pixel-ranking-in-serp-api>)

## Base URL

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

## Authentication

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

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string",
            "description": "<p><em>kata kunci</em><p><strong>field wajib</strong><p>Anda dapat menentukan <strong>hingga 700 karakter</strong> di field <code>keyword</code><p>semua %## akan didekode (karakter ‘+’ akan didekode menjadi karakter spasi)<p>jika Anda perlu menggunakan karakter “%” untuk <code>keyword</code>, tentukan sebagai “%25”;<p>jika Anda perlu menggunakan karakter “+” untuk <code>keyword</code>, tentukan sebagai “%2B”</p><br><p>pelajari lebih lanjut tentang aturan dan batasan field <code>keyword</code> dan <code>keywords</code> di API DataForSEO di artikel Pusat Bantuan</p>"
          },
          "location_code": {
            "type": "integer",
            "description": "<p><em>kode lokasi mesin pencari</em><p><strong>field wajib jika Anda tidak menentukan</strong> <code>location_name</code>&nbsp;atau <code>location_coordinate</code><p><strong>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>location_name</code> atau <code>location_coordinate</code></strong><p>Anda dapat menerima daftar lokasi mesin pencari yang tersedia beserta <code>location_code</code> dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/google/locations</code><p><strong>Catatan:</strong> periksa Google Search Help untuk daftar negara tempat AI Mode saat ini tersedia</p>"
          },
          "language_code": {
            "type": "string",
            "description": "<p><em>kode bahasa mesin pencari</em><p>field wajib jika Anda tidak menentukan <code>language_name</code>;<p>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>language_name</code>;<p>Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta <code>language_code</code>-nya&nbsp;dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/google/ai_mode/languages</code></p>"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>prioritas tugas</em><p>field opsional<p>dapat mengambil nilai berikut:<p>1 – prioritas eksekusi normal (ditetapkan secara default)<p>2 – prioritas eksekusi tinggi</p><br>Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi.<p>Biaya dapat dihitung di halaman Harga."
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>jenis perangkat</em><p>field opsional<p>kembalikan hasil untuk jenis perangkat tertentu<p>dapat mengambil nilai:<code>desktop</code>, <code>mobile</code><p>nilai default: <code>desktop</code></p>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>URL notifikasi tugas yang selesai</em><p>field opsional<p>setelah tugas selesai, kami akan memberi tahu Anda dengan permintaan GET yang dikirim ke URL yang Anda tentukan<p>Anda dapat menggunakan string ‘$id’ sebagai variabel <code>$id</code> dan ‘$tag’ sebagai variabel <code>$tag</code> yang dienkode URL. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.<p>contoh:<p><code>http://your-server.com/pingscript?id=$id</code><p><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><p><strong>Catatan:</strong> karakter khusus di <code>pingback_url</code> akan dienkode URL;<p>khususnya, karakter <code>#</code> akan dienkode menjadi <code>%23</code></p><br><p>pelajari lebih lanjut di Pusat Bantuan kami</p>"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>URL untuk mengirim hasil tugas</em><p>field opsional<p>setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format <code>gzip</code> ke <code>postback_url</code> yang Anda tentukan<p>Anda dapat menggunakan string ‘$id’ sebagai variabel <code>$id</code> dan ‘$tag’ sebagai variabel <code>$tag</code> yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.<p>contoh:<p><code>http://your-server.com/postbackscript?id=$id</code><p><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><p><strong>Catatan:</strong> karakter khusus dalam <code>postback_url</code> akan di-urlencode;<p>yaitu, karakter <code>#</code> akan dienkode menjadi <code>%23</code></p><br><p>pelajari selengkapnya di Pusat Bantuan kami</p>"
          },
          "postback_data": {
            "type": "string",
            "description": "<p><em>tipe data postback_url</em><p><strong>field wajib jika Anda menentukan <code>postback_url</code></strong><p>sesuai dengan fungsi yang Anda gunakan untuk menyetel tugas<p>nilai yang mungkin:<p><code>advanced</code>, <code>html</code></p>"
          },
          "location_name": {
            "type": "string",
            "description": "<p><em>nama lengkap lokasi mesin pencari</em><p><strong>field wajib jika Anda tidak menentukan</strong> <code>location_code</code> atau <code>location_coordinate</code><p><strong>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>location_code</code> atau <code>location_coordinate</code></strong><p>Anda dapat menerima daftar lokasi mesin pencari yang tersedia beserta <code>location_name</code> dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/google/locations</code><p><strong>Catatan:</strong> periksa Google Search Help untuk daftar negara tempat AI Mode saat ini tersedia</p>"
          },
          "language_name": {
            "type": "string",
            "description": "<p><em>nama lengkap bahasa mesin pencari</em><p>field wajib jika Anda tidak menentukan <code>language_code</code>;<p>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>language_code</code>;<p>Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta <code>language_name</code>-nya dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/google/ai_mode/languages</code>;</p>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>sistem operasi perangkat</em><p>field opsional<p>jika Anda menentukan <code>desktop</code> di field <code>device</code>, pilih dari nilai berikut: <code>windows</code>, <code>macos</code><p>nilai default: <code>windows</code><p>jika Anda menentukan <code>mobile</code> di field <code>device</code>, pilih dari nilai berikut: <code>android</code>, <code>ios</code><p>nilai default: <code>android</code></p>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>pengenal tugas yang ditentukan pengguna</em><p>field opsional<p><em>batas karakter adalah 255</em><p>Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil<p>Anda akan menemukan nilai <code>tag</code> yang ditentukan di objek <code>data</code> pada respons</p>"
          },
          "calculate_rectangles": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<p><em>hitung peringkat piksel untuk elemen SERP dalam hasil lanjutan</em><p>field opsional<p>peringkat piksel mengacu pada jarak antara cuplikan hasil dan sudut kiri atas layar;<p>Kunjungi Pusat Bantuan untuk mempelajari lebih lanjut&gt;&gt;<p>secara default, parameter diatur ke <code>false</code><p><strong>Catatan:</strong> jika diatur ke <code>true</code>, biaya per tugas akan dikalikan 2</p>"
          },
          "browser_screen_width": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>lebar layar browser</em><p>field opsional<p>Anda dapat menetapkan lebar layar browser kustom untuk menghitung peringkat piksel untuk perangkat tertentu;<p>dapat ditentukan dalam rentang berikut: <code>240-9999</code>;<p>secara default, parameter diatur ke:<p><code>1920</code> untuk <code>desktop</code>;<p><code>360</code> untuk <code>mobile</code> di <code>android</code>;<p><code>375</code> untuk <code>mobile</code> di <code>iOS</code>;<p><strong>Catatan:</strong> untuk menggunakan parameter ini, setel <code>calculate_rectangles</code> ke <code>true</code></p>",
            "format": "int64"
          },
          "browser_screen_height": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>tinggi layar browser</em><p>field opsional<p>Anda dapat menetapkan tinggi layar browser kustom untuk menghitung peringkat piksel untuk perangkat tertentu;<p>dapat ditentukan dalam rentang berikut: <code>240-9999</code>;<p>secara default, parameter diatur ke:<p><code>1080</code> untuk <code>desktop</code>;<p><code>640</code> untuk <code>mobile</code> di <code>android</code>;<p><code>812</code> untuk <code>mobile</code> di <code>iOS</code>;<p><strong>Catatan:</strong> untuk menggunakan parameter ini, setel <code>calculate_rectangles</code> ke <code>true</code></p>"
          },
          "browser_screen_resolution_ratio": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>rasio resolusi layar browser</em><p>field opsional<p>Anda dapat menetapkan rasio resolusi layar browser kustom untuk menghitung peringkat piksel untuk perangkat tertentu;<p>dapat ditentukan dalam rentang berikut: <code>0.5-3</code>;<p>secara default, parameter diatur ke:<p><code>1</code> untuk <code>desktop</code>;<p><code>3</code> untuk <code>mobile</code> di <code>android</code>;<p><code>3</code> untuk <code>mobile</code> di <code>iOS</code>;<p><strong>Catatan:</strong> untuk menggunakan parameter ini, setel <code>calculate_rectangles</code> ke <code>true</code></p>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<p><em>koordinat GPS suatu lokasi</em><p><strong>field wajib jika Anda tidak menentukan</strong> <code>location_name</code>&nbsp;atau <code>location_code</code><p><strong>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>location_name</code> atau <code>location_code</code></strong><p>parameter <code>location_coordinate</code> harus ditentukan dalam format <em>\"latitude,longitude,zoom\"</em><p>jika <em>\"zoom\"</em> tidak ditentukan, <em>9z</em> akan diterapkan sebagai nilai default<p>jumlah maksimum digit desimal untuk <em>\"latitude\"</em> dan <em>\"longitude\"</em>: 7<p>nilai minimum untuk <em>\"zoom\"</em>: 4z<p>nilai maksimum untuk <em>\"zoom\"</em>: 18z<p>contoh:<p><code class=\"long-string\">52.6178549,-155.352142,18z</code></p>"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "keyword": "what is google ai mode"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "keyword": "what is google ai mode"
    }
  ]
}
```

## Responses

### 200 — Operasi berhasil

Headers:
- `X-Request-Id` (string) — Pengenal permintaan yang harus disertakan saat menghubungi dukungan Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeTaskPostResponseInfo"
    }
  ]
}
```

### 400 — Permintaan tidak dapat diproses. Periksa parameter permintaan.

### 401 — Kunci API Felo yang valid diperlukan.

### 402 — Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

### 403 — Akun tidak diizinkan melakukan operasi ini.

### 429 — Batas permintaan atau batas pengeluaran telah tercapai.

### 502 — Layanan tidak dapat menyelesaikan permintaan.

### 503 — API atau layanan penagihan untuk sementara tidak tersedia.

### 504 — Layanan kehabisan waktu saat memproses permintaan.

### default — Respons error; respons passthrough upstream dapat menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "versi API saat ini"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "total waktu eksekusi, detik"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total biaya tugas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah tugas dalam array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah tugas dalam array tasks yang dikembalikan dengan error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "waktu eksekusi, detik"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total biaya tugas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah elemen dalam array hasil",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Jalur URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleAiModeTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>array tugas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleAiModeTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>array hasil</em><br>dalam kasus ini, nilainya akan menjadi <code>null</code>"
        }
      }
    }
  ]
}
```
