# Baidu Organik SERP Görevlerini Ayarlama

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/baidu/organic/task_post`

**Tags:** DataForSEO

Baidu'da bir anahtar kelime için sıralı sonuçları kuyruğa alır ve `tasks[0].id` içinde bir görev `id` değeri döndürür. DataForSEO zarfına sarılıdır: veriler `tasks[0].result` içinde, sonuç `tasks[0].status_code` içinde — reddedilen bir istek yine de HTTP 200 döndürür. Canlı eşi hemen yanıtlar ve tek bir sorgu için daha basittir; toplu iş bir araç çağrısını aşacaksa kuyruğa alın.

### Fiyatlandırma referansı

- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.02.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

## Related links

- [Yardım Merkezi makalesine](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [Fiyatlandırma](<https://dataforseo.com/pricing/serp/baidu-organic-serp-api>)
- [arama motoru 10'dan fazla sonuç döndürürse](<https://dataforseo.com/help-center/how-many-results-scraped>)
- [yardım merkezimize](<https://dataforseo.com/help-center/what-is-max-crawl-pages-and-how-does-it-work>)
- [Yardım Merkezimize](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-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": "<em>anahtar kelime</em><br><strong>zorunlu alan</strong><br><code>keyword</code> alanında <strong>en fazla 700 karakter</strong> belirtebilirsiniz<br>tüm %## kodları çözülür (‘+’ karakteri boşluk karakteri olarak çözülür)<br><code>keyword</code> için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;<br><code>keyword</code> için “+” karakterini kullanmanız gerekiyorsa “%2B” olarak belirtin<p>DataForSEO API'lerinde <code>keyword</code> ve <code>keywords</code> alanlarının kural ve sınırlamaları hakkında daha fazla bilgi için Yardım Merkezi makalesine bakın"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>görev önceliği</em><br>isteğe bağlı alan<br>şu değerleri alabilir:<br>1 – normal yürütme önceliği (varsayılan olarak ayarlanır)<br>2 – yüksek yürütme önceliği<br>Yüksek yürütme önceliğine sahip görevler için ek ücret alınır.<br>Maliyet Fiyatlandırma sayfasında hesaplanabilir."
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>ayrıştırma derinliği</em><br>isteğe bağlı alan<br>SERP'teki sonuç sayısı<br>varsayılan değer: <code>10</code><br>maksimum değer: <code>700</code><br><strong>Hesabınız 10 sonuca kadar içeren her SERP için faturalandırılır;</strong> <br>10'un üzerinde derinlik ayarlamak arama motoru 10'dan fazla sonuç döndürürse ek ücretlere yol açabilir;<br>Maliyet Fiyatlandırma sayfasında hesaplanabilir."
          },
          "max_crawl_pages": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>sayfa tarama limiti</em><br>isteğe bağlı alan<br>taranacak arama sonuçları sayfası sayısı<br>varsayılan değer: <code>1</code><br>maksimum değer: <code>100</code><br><strong>Not:</strong> <code>max_crawl_pages</code> ve <code>depth</code> parametreleri birbirini tamamlar;<br>daha fazla bilgi için yardım merkezimize bakın"
          },
          "language_name": {
            "type": "string",
            "description": "<em>arama motoru dilinin tam adı</em><br><strong><code>language_code</code> belirtmezseniz zorunlu alan</strong><br>arama motorunun mevcut dillerinin listesini <code>language_name</code> değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><strong>not</strong>: Baidu arama motorunda desteklenen tek dil <code>Chinese (Simplified)</code> dilidir. Ancak Baidu başka dillerdeki sorgular için de sonuç döndürebilir, bu nedenle <code>keyword</code> değerini Çince belirtmek zorunlu değildir<p>örnek:<br><code class=\"long-string\">Chinese (Simplified)</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>arama motoru dil kodu</em><br><strong><code>language_name</code> belirtmezseniz zorunlu alan</strong><br>arama motorunun mevcut dillerinin listesini <code>language_code</code> değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><strong>not</strong>: Baidu arama motorunda desteklenen tek dil <code>zh_CN</code> dil koduna sahip <code>Chinese (Simplified)</code> dilidir. Ancak Baidu başka dillerdeki sorgular için de sonuç döndürebilir, bu nedenle <code>keyword</code> değerini Çince belirtmek zorunlu değildir<p>örnek:<br><code class=\"long-string\">zh_CN</code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>arama motoru konumunun tam adı</em><br><strong><code>location_code</code> veya <code>location_coordinate</code> belirtmezseniz zorunlu alan</strong><br><strong>bu alanı kullanırsanız <code>location_code</code> veya <code>location_coordinate</code> belirtmeniz gerekmez</strong><br>arama motorunun mevcut konumlarının listesini <code>location_name</code> değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><br>örnek:<br><code class=\"long-string\">New York,New York,United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>arama motoru konum kodu</em><br><strong><code>location_name</code> veya <code>location_coordinate</code> belirtmezseniz zorunlu alan</strong><br><strong>bu alanı kullanırsanız <code>location_name</code> veya <code>location_coordinate</code> belirtmeniz gerekmez</strong><br>arama motorlarının mevcut konumlarının listesini <code>location_code</code> değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><br>örnek:<br><code class=\"long-string\">2156</code>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<em>bir konumun GPS koordinatları</em><br><strong><code>location_name</code> veya <code>location_code</code> belirtmezseniz zorunlu alan</strong><br><strong>bu alanı kullanırsanız <code>location_name</code> veya <code>location_code</code> belirtmeniz gerekmez</strong><br><code>location_coordinate</code> parametresi <em>\"latitude,longitude,radius\"</em> biçiminde belirtilmelidir<br><em>\"latitude\"</em> ve <em>\"longitude\"</em> için maksimum ondalık basamak sayısı: 7<br><em>\"radius\"</em> için minimum değer: 199.9 (mm)<br><em>\"radius\"</em> için maksimum değer: 199999 (mm)bu alanı kullanırsanız döndürülen sonuçlar koordinatlarınız için bulunan en yakın şehre dayanır. Bu nedenle sonuçlar belirtilen koordinatlarla ilgili olmayabileceğinden bu alanı kullanmanızı <strong>önermiyoruz</strong><br>örnek:<br><code class=\"long-string\">53.476225,-2.243572,200</code>"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>cihaz türü</em><br>isteğe bağlı alan<br>belirli bir cihaz türü için sonuç döndür<br>şu değerleri alabilir: <code>desktop</code>, <code>mobile</code>, <code>tablet</code><br>varsayılan değer: <code>desktop</code>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>cihaz işletim sistemi</em><br>isteğe bağlı alan<br><code>device</code> alanında <code>desktop</code> belirtirseniz şu değerlerden birini seçin: <code>windows</code>, <code>macos</code><br>varsayılan değer: <code>windows</code><br><code>device</code> alanında <code>mobile</code> belirtirseniz şu değerlerden birini seçin: <code>android</code>, <code>ios</code><br>varsayılan değer: <code>android</code><br><code>device</code> alanında <code>tablet</code> belirtirseniz şu değerlerden birini seçin: <code>android</code>, <code>ios</code><br>varsayılan değer: <code>android</code>"
          },
          "get_website_url": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>sıralanan her sonuç için doğrudan URL ekle</em><br>isteğe bağlı alan<br><code>true</code> olarak ayarlanırsa döndürülen sonuçlar sıralanan sitelerin doğrudan URL'lerini içerir<br>varsayılan olarak Baidu sonuçlarındaki URL'ler arama motoru tarafından kodlanır,<br>örnek:<br><code>http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kL</code>varsayılan değer: <code>false</code><br><strong>Not:</strong> <code>true</code> olarak ayarlanırsa, her sıralanan site için doğrudan URL'sini döndürmek üzere sistemimiz ayrı bir istek çalıştırdığından <strong>görev başına ücret 10 ile çarpılır</strong>"
          },
          "stop_crawl_on_match": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ],
              "oneOf": [
                {
                  "type": "object",
                  "properties": {
                    "match_value": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "hedef alan adı veya joker değeri\nstop_crawl_on_match belirtilirse zorunlu alan;\nbir hedef alan adı veya joker değeri belirtin;\nNot: alan adı istek protokolü olmadan belirtilmelidir;\nörnek: dataforseo.com"
                    },
                    "match_type": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "hedef eşleme türü\nstop_crawl_on_match belirtilirse zorunlu alan;\nmatch_value için eşleme türü\nolası değerler: domain, with_subdomains, wildcard"
                    }
                  }
                }
              ]
            },
            "description": "taramayı durduracak hedef dizisi\nisteğe bağlı alan\nbelirtilirse yanıt, belirtilen match_value dahil olmak üzere bu değere kadar SERP sonuçlarını içerir;\nbu dizide en fazla 10 hedef değer belirtebilirsiniz\nörnek:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nbu parametre hakkında daha fazla bilgi için Yardım Merkezimize bakın — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nHesabınız, belirtilen hedefler üzerinden taranan her SERP için faturalandırılır"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>kullanıcı tanımlı görev tanımlayıcısı</em><br>isteğe bağlı alan<br><em>karakter sınırı 255</em><br>bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz<br>belirtilen <code>tag</code> değerini yanıtın <code>data</code> nesnesinde bulacaksınız"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>görev sonuçlarını göndermek için URL</em><br>isteğe bağlı alan<br>görev tamamlandığında sonuçlarını <code>gzip</code> biçiminde sıkıştırarak belirttiğiniz <code>postback_url</code> adresine POST isteğiyle göndereceğiz<br>‘$id’ dizesini <code>$id</code> değişkeni, ‘$tag’ dizesini ise URL kodlu <code>$tag</code> değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.<br>örnek:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>Not:</strong> <code>postback_url</code> içindeki özel karakterler URL kodlanır;<br>yani, <code>#</code> karakteri <code>%23</code> olarak kodlanır<p>daha fazla bilgi için Yardım Merkezimize bakın"
          },
          "postback_data": {
            "type": "string",
            "description": "<em>postback_url veri türü</em><br><strong><code>postback_url</code> belirtirseniz zorunlu alan</strong><br>sunucunuza gönderilecek veri türüne karşılık gelir<br>olası değerler:<br><code>regular</code>, <code>html</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tamamlanan görevin bildirim URL'si</em><br>isteğe bağlı alan<br>görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz<br>‘$id’ dizesini <code>$id</code> değişkeni, ‘$tag’ dizesini ise URL kodlu <code>$tag</code> değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.<br>örnek:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>Not:</strong> <code>pingback_url</code> içindeki özel karakterler URL kodlanır;<br>yani, <code>#</code> karakteri <code>%23</code> olarak kodlanır<p>daha fazla bilgi için Yardım Merkezimize bakın"
          }
        },
        "example": [
          {
            "location_code": 2156,
            "keyword": "best iphone ever",
            "tag": "some_string_123",
            "priority": 2
          }
        ]
      }
    ]
  },
  "example": [
    {
      "location_code": 2156,
      "keyword": "best iphone ever",
      "tag": "some_string_123",
      "priority": 2
    }
  ]
}
```

## Responses

### 200 — Başarılı işlem

Headers:
- `X-Request-Id` (string) — Felo desteğiyle iletişime geçerken belirtilecek istek tanımlayıcısı.

**application/json**

Schema: object | null

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

### 400 — İstek işlenemedi. İstek parametrelerini kontrol edin.

### 401 — Geçerli bir Felo API anahtarı gerekir.

### 402 — Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

### 403 — Hesabın bu işlemi gerçekleştirme izni yok.

### 429 — İstek veya harcama sınırına ulaşıldı.

### 502 — Hizmet isteği tamamlayamadı.

### 503 — API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

### 504 — İstek işlenirken hizmet zaman aşımına uğradı.

### default — Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "API'nin geçerli sürümü"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "genel durum kodu\nyanıt kodlarının tam listesini burada bulabilirsiniz"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "genel bilgilendirme mesajı\ngenel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "toplam yürütme süresi, saniye"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "toplam görev maliyeti, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "tasks dizisindeki görev sayısı",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "tasks dizisinde hata ile dönen görev sayısı",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "görev tanımlayıcısı\nsistemimizde UUID biçiminde benzersiz görev tanımlayıcısı"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "görevin durum kodu\nDataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000\nyanıt kodlarının tam listesini burada bulabilirsiniz"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "görevin bilgilendirme mesajı\ngenel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "yürütme süresi, saniye"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "toplam görev maliyeti, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "result dizisindeki öğe sayısı",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "URL yolu"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "POST isteğinde belirttiğiniz parametrelerin aynısını içerir"
    }
  }
}
```

### Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo`

```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_SerpBaiduOrganicTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>görev dizisi</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>sonuç dizisi</em><br>bu durumda değer <code>null</code> olur"
        }
      }
    }
  ]
}
```
