# Tạo tác vụ SERP Google Images

**API:** Data API

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

**Tags:** DataForSEO

Xếp hàng kết quả hình ảnh cho một từ khóa trên Google, trả về `id` tác vụ trong `tasks[0].id`. Được bọc trong phong bì của DataForSEO: dữ liệu ở `tasks[0].result`, kết quả ở `tasks[0].status_code` - yêu cầu bị từ chối vẫn trả về HTTP 200. Bản trực tiếp trả lời ngay và đơn giản hơn cho một truy vấn đơn lẻ; hãy xếp hàng khi lô yêu cầu sẽ kéo dài hơn một lượt gọi công cụ.

### Tham chiếu giá

- Đo lường: Chi phí phản hồi được báo cáo.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

## Related links

- [bài viết Trung tâm trợ giúp](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [Bảng giá](<https://dataforseo.com/pricing/serp/google-images-serp-api>)
- [Trung tâm trợ giúp](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)
- [trung tâm trợ giúp của chúng tôi](<https://dataforseo.com/help-center/what-is-max-crawl-pages-and-how-does-it-work>)
- [lấy danh sách các tham số khả dụng và thông tin chi tiết bổ sung tại đây](<https://dataforseo.com/help-center/google-search-engine-parameters-and-how-to-use-them>)

## 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>từ khóa</em><p><strong>trường bắt buộc</strong><p>bạn có thể chỉ định <strong>tối đa 700 ký tự</strong> trong trường <code>keyword</code><p>mọi %## sẽ được giải mã (ký tự ‘+’ sẽ được giải mã thành ký tự khoảng trắng)<p>nếu bạn cần dùng ký tự “%” cho <code>keyword</code>, hãy chỉ định là “%25”;<p>nếu bạn cần dùng ký tự “+” cho <code>keyword</code>, hãy chỉ định là “%2B”;<p>nếu trường này chứa các tham số như <em>‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’</em>, <strong>phí mỗi tác vụ sẽ được nhân với 5</strong><p><strong>Lưu ý:</strong> các truy vấn chứa tham số ‘cache:’ không được hỗ trợ và sẽ trả về lỗi xác thực</p><br><p>tìm hiểu thêm về quy tắc và giới hạn của các trường <code>keyword</code> và <code>keywords</code> trong API DataForSEO tại bài viết Trung tâm trợ giúp này</p>"
          },
          "location_code": {
            "type": "integer",
            "description": "<p><em>mã vị trí công cụ tìm kiếm</em><p><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>location_name</code>&nbsp;hoặc <code>location_coordinate</code><p><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>location_name</code> hoặc <code>location_coordinate</code></strong><p>bạn có thể nhận danh sách vị trí khả dụng của công cụ tìm kiếm với <code>location_code</code> bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><p>ví dụ:<p><code class=\"long-string\">2840</code></p>"
          },
          "language_code": {
            "type": "string",
            "description": "<p><em>mã ngôn ngữ của công cụ tìm kiếm</em><p><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>language_name</code><p><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>language_name</code></strong><p>bạn có thể nhận danh sách ngôn ngữ khả dụng của công cụ tìm kiếm với <code>language_code</code>&nbsp;bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><em><p></em>ví dụ:<em><p></em><code class=\"long-string\">en</code></p>"
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>độ sâu phân tích</em><p>trường tùy chọn<p>số kết quả trong SERP<p>giá trị mặc định: <code>100</code><p>giá trị tối đa: <code>700</code></p><br><strong>Tài khoản của bạn sẽ bị tính phí cho mỗi SERP chứa tối đa 100 kết quả;</strong><p>Đặt độ sâu trên 100 có thể phát sinh thêm phí nếu công cụ tìm kiếm trả về hơn 100 kết quả;<p>Nếu độ sâu đã chỉ định cao hơn số kết quả trong phản hồi, phần chênh lệch sẽ được tự động hoàn lại vào số dư tài khoản của bạn;<p>Chi phí có thể được tính trên trang Bảng giá."
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>độ ưu tiên tác vụ</em><p>trường tùy chọn<p>có thể nhận các giá trị sau:<p>1 – độ ưu tiên thực thi bình thường (đặt mặc định)<p>2 – độ ưu tiên thực thi cao</p><br>Bạn sẽ bị tính thêm phí cho các tác vụ có độ ưu tiên thực thi cao.<p>Chi phí có thể được tính trên trang Bảng giá."
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>URL thông báo của tác vụ đã hoàn tất</em><p>trường tùy chọn<p>khi tác vụ hoàn tất, chúng tôi sẽ thông báo cho bạn bằng yêu cầu GET gửi đến URL bạn đã chỉ định<p>bạn có thể dùng chuỗi ‘$id’ làm biến <code>$id</code> và ‘$tag’ làm biến <code>$tag</code> được mã hóa URL. Chúng tôi sẽ đặt các giá trị cần thiết trước khi gửi yêu cầu.<p>ví dụ:<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>Lưu ý:</strong> ký tự đặc biệt trong <code>pingback_url</code> sẽ được mã hóa URL;<p>cụ thể, ký tự <code>#</code> sẽ được mã hóa thành <code>%23</code></p><br><p>tìm hiểu thêm trên Trung tâm trợ giúp của chúng tôi</p>"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>URL để gửi kết quả tác vụ</em><p>trường tùy chọn<p>khi tác vụ hoàn tất, chúng tôi sẽ gửi yêu cầu POST với kết quả được nén ở định dạng <code>gzip</code> đến <code>postback_url</code> bạn đã chỉ định<p>bạn có thể dùng chuỗi ‘$id’ làm biến <code>$id</code> và ‘$tag’ làm biến <code>$tag</code> được mã hóa URL. Chúng tôi sẽ đặt các giá trị cần thiết trước khi gửi yêu cầu.<p>ví dụ:<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>Lưu ý:</strong> các ký tự đặc biệt trong <code>postback_url</code> sẽ được mã hóa URL;<p>tức là, ký tự <code>#</code> sẽ được mã hóa thành <code>%23</code></p><br><p>tìm hiểu thêm trên Trung tâm trợ giúp của chúng tôi</p>"
          },
          "postback_data": {
            "type": "string",
            "description": "<p><em>kiểu dữ liệu postback_url</em><p><strong>trường bắt buộc nếu bạn chỉ định <code>postback_url</code></strong><p>tương ứng với kiểu dữ liệu sẽ được gửi đến máy chủ của bạn<p>giá trị khả dụng:<p><code>advanced</code>, <code>html</code></p>"
          },
          "location_name": {
            "type": "string",
            "description": "<p><em>tên đầy đủ của vị trí công cụ tìm kiếm</em><p><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>location_code</code> hoặc <code>location_coordinate</code><p><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>location_code</code> hoặc <code>location_coordinate</code></strong><p>bạn có thể nhận danh sách vị trí khả dụng của công cụ tìm kiếm cùng <code>location_name</code> bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><p>ví dụ:<p><code class=\"long-string\">London,England,United Kingdom</code></p>"
          },
          "language_name": {
            "type": "string",
            "description": "<p><em>tên đầy đủ của ngôn ngữ công cụ tìm kiếm</em><p><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>language_code</code><p><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>language_code</code></strong><p>bạn có thể nhận danh sách ngôn ngữ khả dụng của công cụ tìm kiếm với <code>language_name</code> bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><p>ví dụ:<p><code class=\"long-string\">English</code></p>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>hệ điều hành thiết bị</em><p>trường tùy chọn<p><strong>lưu ý rằng API này chỉ cung cấp kết quả cho desktop</strong><p>chọn một trong các giá trị sau: <code>windows</code>, <code>macos</code><p>giá trị mặc định: <code>windows</code></p>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>mã định danh tác vụ do người dùng xác định</em><p>trường tùy chọn<p><em>giới hạn ký tự là 255</em><p>bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả<p>bạn sẽ thấy giá trị <code>tag</code> đã chỉ định trong đối tượng <code>data</code> của phản hồi</p>"
          },
          "max_crawl_pages": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>giới hạn thu thập trang</em><p>trường tùy chọn<p>số trang kết quả tìm kiếm cần thu thập<p>giá trị tối đa: <code>100</code><p><strong>Lưu ý:</strong> các tham số <code>max_crawl_pages</code> và <code>depth</code> bổ sung cho nhau;<p>tìm hiểu thêm tại trung tâm trợ giúp của chúng tôi</p>"
          },
          "search_param": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>tham số bổ sung của truy vấn tìm kiếm</em><p>trường tùy chọn<p>lấy danh sách các tham số khả dụng và thông tin chi tiết bổ sung tại đây</p>"
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>URL trực tiếp của truy vấn tìm kiếm</em><p>trường tùy chọn<p>bạn có thể chỉ định URL trực tiếp và chúng tôi sẽ phân tách nó thành các trường cần thiết. Lưu ý rằng phương pháp này khó xử lý nhất đối với API của chúng tôi và cũng yêu cầu bạn chỉ định chính xác ngôn ngữ và vị trí trong URL. Trong hầu hết trường hợp, chúng tôi không khuyên dùng phương pháp này.<p>ví dụ:<p><code class=\"long-string\">https://www.google.co.uk/search?q=%20rank%20tracker%20api&amp;hl=en&amp;gl=GB&amp;uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS</code></p>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<p><em>tọa độ GPS của một vị trí</em><p><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>location_name</code>&nbsp;hoặc <code>location_code</code><p><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>location_name</code> hoặc <code>location_code</code></strong><p>tham số <code>location_coordinate</code> phải được chỉ định ở định dạng <em>\"latitude,longitude,radius\"</em><p>số chữ số thập phân tối đa cho <em>\"latitude\"</em> và <em>\"longitude\"</em>: 7<p>giá trị tối thiểu cho <em>\"radius\"</em>: 199.9 (mm)<p>giá trị tối đa cho <em>\"radius\"</em>: 199999 (mm)<p>ví dụ:<p><code class=\"long-string\">53.476225,-2.243572,200</code></p>"
          },
          "se_domain": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>tên miền công cụ tìm kiếm</em><p>trường tùy chọn<p>chúng tôi tự động chọn tên miền công cụ tìm kiếm phù hợp theo vị trí và ngôn ngữ bạn chỉ định<p>tuy nhiên, bạn có thể đặt tên miền công cụ tìm kiếm tùy chỉnh trong trường này<p>ví dụ:<p><code><code></code></code><em>google.co.uk</em>, <code><code></code></code><em>google.com.au</em>, <code><code></code></code><em>google.de</em>, v.v.</p>"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "keyword": "albert einstein"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "keyword": "albert einstein"
    }
  ]
}
```

## Responses

### 200 — Thao tác thành công

Headers:
- `X-Request-Id` (string) — Mã định danh yêu cầu cần bao gồm khi liên hệ bộ phận hỗ trợ Felo.

**application/json**

Schema: object | null

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

### 400 — Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

### 401 — Cần có khóa API Felo hợp lệ.

### 402 — Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

### 403 — Tài khoản không được phép thực hiện thao tác này.

### 429 — Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

### 502 — Dịch vụ không thể hoàn tất yêu cầu.

### 503 — API hoặc dịch vụ thanh toán tạm thời không khả dụng.

### 504 — Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

### default — Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "phiên bản hiện tại của API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tổng thời gian thực thi, giây"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "tổng chi phí tác vụ, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "số lượng tác vụ trong mảng tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "số lượng tác vụ trong mảng tasks được trả về kèm lỗi",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "thời gian thực thi, giây"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "tổng chi phí tác vụ, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "số phần tử trong mảng kết quả",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Đường dẫn URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleImagesTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleImagesTaskPostResponseInfo`

```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_SerpGoogleImagesTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>mảng tác vụ</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleImagesTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleImagesTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>mảng kết quả</em><br>trong trường hợp này, giá trị sẽ là <code>null</code>"
        }
      }
    }
  ]
}
```
