# Google Dataset Search टास्क सेट करें

**API:** Data API

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

**Tags:** DataForSEO

Google पर Google Dataset Search में क्वेरी से मेल खाने वाले डेटासेट कतार में डालता है और `tasks[0].id` में task `id` लौटाता है। DataForSEO के envelope में लिपटा: डेटा `tasks[0].result` में, परिणाम `tasks[0].status_code` में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। लाइव जुड़वाँ endpoint तुरंत उत्तर देता है और एकल क्वेरी के लिए सरल है; जब बैच एक टूल कॉल से अधिक समय ले तो कतार में डालें।

### मूल्य संदर्भ

- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.02
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।

यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।

## Related links

- [इस Help Center लेख](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [Pricing](<https://dataforseo.com/pricing/serp/google-dataset-search-serp-api>)
- [Help Center](<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": "<p><em>कीवर्ड</em><p><strong>आवश्यक फ़ील्ड</strong><p>आप <code>keyword</code> फ़ील्ड में <strong>अधिकतम 700 अक्षर</strong> निर्दिष्ट कर सकते हैं<p>सभी %## डिकोड किए जाएँगे (साथ ही ‘+’ अक्षर एक स्पेस अक्षर में डिकोड होगा)<p>यदि आप अपने <code>keyword</code> के लिए “%” अक्षर उपयोग करना चाहते हैं, तो उसे “%25” के रूप में निर्दिष्ट करें;<p>यदि आप अपने <code>keyword</code> के लिए “+” अक्षर उपयोग करना चाहते हैं, तो उसे “%2B” के रूप में निर्दिष्ट करें।</p><br><p>DataForSEO API में <code>keyword</code> और <code>keywords</code> फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में और जानें</p>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>सर्च इंजन भाषा कोड</em><p>वैकल्पिक फ़ील्ड<p>संभावित मान:<p><code class=\"long-string\">en</code></p>"
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>पार्सिंग गहराई</em><p>वैकल्पिक फ़ील्ड<p>SERP में परिणामों की संख्या<p>डिफ़ॉल्ट मान: <code>20</code><p>अधिकतम मान: <code>700</code></p><br><strong>ऐसे प्रत्येक SERP के लिए आपके खाते से बिल लिया जाएगा जिसमें अधिकतम 20 परिणाम हों;</strong><p>20 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 20 से अधिक परिणाम लौटाता है;<p>यदि निर्दिष्ट गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वतः आपके खाते की शेष राशि में वापस कर दिया जाएगा;"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>टास्क प्राथमिकता</em><p>वैकल्पिक फ़ील्ड<p>निम्नलिखित मान ले सकता है:<p>1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट)<p>2 – उच्च निष्पादन प्राथमिकता</p><br>उच्च निष्पादन प्राथमिकता वाले टास्क के लिए आपसे अतिरिक्त शुल्क लिया जाएगा।<p>लागत Pricing पेज पर गणना की जा सकती है।"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>डिवाइस प्रकार</em><p>वैकल्पिक फ़ील्ड<p>किसी विशिष्ट डिवाइस प्रकार के लिए परिणाम लौटाएँ<p>संभावित मान: <code>desktop</code></p>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>पूर्ण टास्क का नोटिफिकेशन URL</em><p>वैकल्पिक फ़ील्ड<p>जब कोई टास्क पूरा होता है, तो हम आपके द्वारा निर्दिष्ट URL पर भेजे गए GET request के माध्यम से आपको सूचित करेंगे<p>आप ‘$id’ स्ट्रिंग को <code>$id</code> वेरिएबल के रूप में और ‘$tag’ को urlencoded <code>$tag</code> वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।<p>उदाहरण:<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>नोट:</strong> <code>pingback_url</code> में विशेष अक्षर urlencoded किए जाएँगे;<p>अर्थात, <code>#</code> अक्षर <code>%23</code> में एन्कोड किया जाएगा</p><br><p>हमारे Help Center पर अधिक जानें</p>"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>टास्क परिणाम भेजने के लिए URL</em><p>वैकल्पिक फ़ील्ड<p>टास्क पूरा होने के बाद, हम <code>gzip</code> प्रारूप में संपीड़ित परिणामों के साथ एक POST request आपके द्वारा निर्दिष्ट <code>postback_url</code> पर भेजेंगे<p>आप ‘$id’ स्ट्रिंग को <code>$id</code> वेरिएबल के रूप में और ‘$tag’ को urlencoded <code>$tag</code> वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।<p>उदाहरण:<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>नोट:</strong> <code>postback_url</code> में विशेष अक्षर urlencode किए जाएँगे;<p>जैसे, <code>#</code> अक्षर <code>%23</code> में एन्कोड हो जाएगा</p><br><p>हमारे Help Center पर और जानें</p>"
          },
          "postback_data": {
            "type": "string",
            "description": "<p><em>postback_url डेटाटाइप</em><p><strong>आवश्यक फ़ील्ड यदि आप <code>postback_url</code> निर्दिष्ट करते हैं</strong><p>आपके सर्वर पर भेजे जाने वाले डेटाटाइप के अनुरूप है<p>केवल मान: <code>advanced</code></p>"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>सर्च इंजन भाषा का पूरा नाम</em><p>वैकल्पिक फ़ील्ड<p>यदि आप यह फ़ील्ड उपयोग करते हैं, तो <code>language_code</code> निर्दिष्ट करने की आवश्यकता नहीं है<p>संभावित मान:<p><code class=\"long-string\">English</code></p>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>डिवाइस ऑपरेटिंग सिस्टम</em><p>वैकल्पिक फ़ील्ड<p>संभावित मान: <code>windows</code>, <code>macos</code><p>डिफ़ॉल्ट मान: <code>windows</code></p>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर</em><p>वैकल्पिक फ़ील्ड<p><em>अक्षर सीमा 255 है</em><p>आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं<p>आप निर्दिष्ट <code>tag</code> मान response के <code>data</code> ऑब्जेक्ट में पाएँगे"
          },
          "last_updated": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>डेटासेट अंतिम बार कब अपडेट हुआ</em><p>वैकल्पिक फ़ील्ड<p>संभावित मान: <code>1m</code>, <code>1y</code>, <code>3y</code></p>"
          },
          "file_formats": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<p><em>डेटासेट के फ़ाइल फ़ॉर्मैट</em><p>वैकल्पिक फ़ील्ड<p>संभावित मान: <code>other</code>, <code>archive</code>, <code>text</code>, <code>image</code>, <code>document</code>, <code>tabular</code></p>"
          },
          "usage_rights": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>डेटासेट के उपयोग अधिकार</em><p>वैकल्पिक फ़ील्ड<p>संभावित मान: <code>commercial</code>, <code>noncommercial</code></p>"
          },
          "is_free": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<p><em>बताता है कि प्रदर्शित डेटासेट मुफ़्त हैं या नहीं</em><p>वैकल्पिक फ़ील्ड<p>संभावित मान: <code>true</code>, <code>false</code></p>"
          },
          "topics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<p><em>डेटासेट विषय</em><p>वैकल्पिक फ़ील्ड<p>संभावित मान: <code>humanities</code>, <code>social_sciences</code>, <code>life_sciences</code>, <code>agriculture</code>, <code>natural_sciences</code>, <code>geo</code>, <code>computer</code>, <code>architecture_and_urban_planning</code>, <code>engineering</code></p>"
          }
        },
        "example": [
          {
            "keyword": "water quality",
            "last_updated": "1m",
            "file_formats": [
              "archive",
              "image"
            ],
            "usage_rights": "noncommercial",
            "is_free": true,
            "topics": [
              "natural_sciences",
              "geo"
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "keyword": "water quality",
      "last_updated": "1m",
      "file_formats": [
        "archive",
        "image"
      ],
      "usage_rights": "noncommercial",
      "is_free": true,
      "topics": [
        "natural_sciences",
        "geo"
      ]
    }
  ]
}
```

## Responses

### 200 — सफल ऑपरेशन

Headers:
- `X-Request-Id` (string) — Felo सहायता से संपर्क करते समय शामिल करने के लिए request पहचानकर्ता।

**application/json**

Schema: object | null

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

### 400 — request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।

### 401 — एक वैध Felo API key आवश्यक है।

### 402 — request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।

### 403 — खाते को यह ऑपरेशन करने की अनुमति नहीं है।

### 429 — request या खर्च की सीमा तक पहुँच गए हैं।

### 502 — सेवा request पूरा नहीं कर सकी।

### 503 — API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।

### 504 — request संसाधित करते समय सेवा का समय समाप्त हो गया।

### default — त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "API का वर्तमान संस्करण"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "सामान्य स्टेटस कोड\nresponse कोड की पूरी सूची यहाँ देखी जा सकती है"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "सामान्य सूचनात्मक संदेश\nसामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "कुल निष्पादन समय, सेकंड"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "टास्क की कुल लागत, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "tasks ऐरे में टास्क की संख्या",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "टास्क आइडेंटिफ़ायर\nहमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "टास्क का स्टेटस कोड\nDataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000\nresponse कोड की पूरी सूची यहाँ देखी जा सकती है"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "टास्क का सूचनात्मक संदेश\nसामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "निष्पादन समय, सेकंड"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "टास्क की कुल लागत, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "result ऐरे में एलिमेंट की संख्या",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "URL पथ"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleDatasetSearchTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleDatasetSearchTaskPostResponseInfo`

```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_SerpGoogleDatasetSearchTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>टास्क का ऐरे</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleDatasetSearchTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleDatasetSearchTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>परिणामों का ऐरे</em><br>इस मामले में, मान <code>null</code> होगा"
        }
      }
    }
  ]
}
```
