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

Felo API Support

MIT

सर्वर

https://openapi.felo.ai

क्लाइंट लाइब्रेरी

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO ऑपरेशन

post/v1/beta/dataforseo/serp/google/dataset_search/task_post

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

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 बिलिंग रिकॉर्ड के अनुसार लगते हैं।

बॉडी

application/json

टाइप: array (object | null)[]
- depth
  टाइप: integer | null
  
  पार्सिंग गहराई
  
  वैकल्पिक फ़ील्ड
  
  SERP में परिणामों की संख्या
  
  डिफ़ॉल्ट मान: 20
  
  अधिकतम मान: 700
  
  ऐसे प्रत्येक SERP के लिए आपके खाते से बिल लिया जाएगा जिसमें अधिकतम 20 परिणाम हों;
  20 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 20 से अधिक परिणाम लौटाता है;
  
  यदि निर्दिष्ट गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वतः आपके खाते की शेष राशि में वापस कर दिया जाएगा;
- device
  टाइप: string | null
  
  डिवाइस प्रकार
  
  वैकल्पिक फ़ील्ड
  
  किसी विशिष्ट डिवाइस प्रकार के लिए परिणाम लौटाएँ
  
  संभावित मान: desktop
- file_formats
  टाइप: array string[] | null
  
  डेटासेट के फ़ाइल फ़ॉर्मैट
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: other, archive, text, image, document, tabular
- is_free
  टाइप: boolean | null
  
  बताता है कि प्रदर्शित डेटासेट मुफ़्त हैं या नहीं
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: true, false
- keyword
  टाइप: string
  
  कीवर्ड
  
  आवश्यक फ़ील्ड
  
  आप keyword फ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैं
  
  सभी %## डिकोड किए जाएँगे (साथ ही ‘+’ अक्षर एक स्पेस अक्षर में डिकोड होगा)
  
  यदि आप अपने keyword के लिए “%” अक्षर उपयोग करना चाहते हैं, तो उसे “%25” के रूप में निर्दिष्ट करें;
  
  यदि आप अपने keyword के लिए “+” अक्षर उपयोग करना चाहते हैं, तो उसे “%2B” के रूप में निर्दिष्ट करें।
  
  DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में और जानें
- language_code
  टाइप: string | null
  
  सर्च इंजन भाषा कोड
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान:
  
  en
- language_name
  टाइप: string | null
  
  सर्च इंजन भाषा का पूरा नाम
  
  वैकल्पिक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है
  
  संभावित मान:
  
  English
- last_updated
  टाइप: string | null
  
  डेटासेट अंतिम बार कब अपडेट हुआ
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: 1m, 1y, 3y
- os
  टाइप: string | null
  
  डिवाइस ऑपरेटिंग सिस्टम
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: windows, macos
  
  डिफ़ॉल्ट मान: windows
- pingback_url
  टाइप: string | null
  
  पूर्ण टास्क का नोटिफिकेशन URL
  
  वैकल्पिक फ़ील्ड
  
  जब कोई टास्क पूरा होता है, तो हम आपके द्वारा निर्दिष्ट URL पर भेजे गए GET request के माध्यम से आपको सूचित करेंगे
  
  आप ‘$id’ स्ट्रिंग को $id वेरिएबल के रूप में और ‘$tag’ को urlencoded $tag वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।
  
  उदाहरण:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  नोट: pingback_url में विशेष अक्षर urlencoded किए जाएँगे;
  
  अर्थात, # अक्षर %23 में एन्कोड किया जाएगा
  
  हमारे Help Center पर अधिक जानें
- postback_data
  टाइप: string
  
  postback_url डेटाटाइप
  
  आवश्यक फ़ील्ड यदि आप postback_url निर्दिष्ट करते हैं
  
  आपके सर्वर पर भेजे जाने वाले डेटाटाइप के अनुरूप है
  
  केवल मान: advanced
- postback_url
  टाइप: string | null
  
  टास्क परिणाम भेजने के लिए URL
  
  वैकल्पिक फ़ील्ड
  
  टास्क पूरा होने के बाद, हम gzip प्रारूप में संपीड़ित परिणामों के साथ एक POST request आपके द्वारा निर्दिष्ट postback_url पर भेजेंगे
  
  आप ‘$id’ स्ट्रिंग को $id वेरिएबल के रूप में और ‘$tag’ को urlencoded $tag वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।
  
  उदाहरण:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  नोट: postback_url में विशेष अक्षर urlencode किए जाएँगे;
  
  जैसे, # अक्षर %23 में एन्कोड हो जाएगा
  
  हमारे Help Center पर और जानें
- priority
  टाइप: integer | null
  
  टास्क प्राथमिकता
  
  वैकल्पिक फ़ील्ड
  
  निम्नलिखित मान ले सकता है:
  
  1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट)
  
  2 – उच्च निष्पादन प्राथमिकता
  
  उच्च निष्पादन प्राथमिकता वाले टास्क के लिए आपसे अतिरिक्त शुल्क लिया जाएगा।
  लागत Pricing पेज पर गणना की जा सकती है।
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  
  वैकल्पिक फ़ील्ड
  
  अक्षर सीमा 255 है
  
  आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
  
  आप निर्दिष्ट tag मान response के data ऑब्जेक्ट में पाएँगे
- topics
  टाइप: array string[] | null
  
  डेटासेट विषय
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: humanities, social_sciences, life_sciences, agriculture, natural_sciences, geo, computer, architecture_and_urban_planning, engineering
- usage_rights
  टाइप: string | null
  
  डेटासेट के उपयोग अधिकार
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: commercial, noncommercial

responses

200
टाइप: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchTaskPostResponseInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

status_code
टाइप: integer | null

सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है

status_message
टाइप: string | null

सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

tasks
टाइप: array (object | null)[] | null

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchTaskPostTaskInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

data
टाइप: object | null

इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे

propertyName
टाइप: object | null
id
टाइप: string | null

टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में

path
टाइप: array (string | null)[] | null

URL पथ

result
टाइप: object | null

परिणामों का ऐरे
इस मामले में, मान null होगा

result_count
टाइप: integer | null फ़ॉर्मेट: int64

result ऐरे में एलिमेंट की संख्या

status_code
टाइप: integer | null

टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है

status_message
टाइप: string | null

टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

time
टाइप: string | null

निष्पादन समय, सेकंड

tasks_count
टाइप: integer | null फ़ॉर्मेट: int64

tasks ऐरे में टास्क की संख्या

tasks_error
टाइप: integer | null फ़ॉर्मेट: int64

त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या

time
टाइप: string | null

कुल निष्पादन समय, सेकंड

version
टाइप: string | null

API का वर्तमान संस्करण
application/json
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

post/v1/beta/dataforseo/serp/google/dataset_search/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "water quality",
    "last_updated": "1m",
    "file_formats": [
      "archive",
      "image"
    ],
    "usage_rights": "noncommercial",
    "is_free": true,
    "topics": [
      "natural_sciences",
      "geo"
    ]
  }
]'

स्कीमा दिखाएँ

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

सफल ऑपरेशन

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

प्रमाणीकरणRequired

DataForSEO

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

मूल्य संदर्भ