Google News SERP टास्क सेट करना

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/news/task_post

Google News SERP टास्क सेट करना

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

मूल्य संदर्भ

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

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

बॉडी

application/json

टाइप: array (object | null)[]
- browser_screen_height
  टाइप: integer | null
  
  ब्राउज़र स्क्रीन ऊँचाई
  
  वैकल्पिक फ़ील्ड
  
  किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन ऊँचाई सेट कर सकते हैं;
  
  डिफ़ॉल्ट रूप से, पैरामीटर 1080 पर सेट है;
  
  नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें
- browser_screen_resolution_ratio
  टाइप: integer | null
  
  ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात
  
  वैकल्पिक फ़ील्ड
  
  किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात सेट कर सकते हैं;
  
  डिफ़ॉल्ट रूप से, पैरामीटर 1 पर सेट है;
  
  नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें
- browser_screen_width
  टाइप: integer | null फ़ॉर्मेट: int64
  
  ब्राउज़र स्क्रीन चौड़ाई
  
  वैकल्पिक फ़ील्ड
  
  किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन चौड़ाई सेट कर सकते हैं;
  
  डिफ़ॉल्ट रूप से, पैरामीटर 1920 पर सेट है;
  
  नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें
- calculate_rectangles
  टाइप: boolean | null
  
  उन्नत परिणामों में SERP तत्वों के लिए पिक्सेल रैंकिंग की गणना करें
  
  वैकल्पिक फ़ील्ड
  
  पिक्सेल रैंकिंग परिणाम स्निपेट और स्क्रीन के ऊपरी बाएँ कोने के बीच की दूरी को दर्शाती है;
  
  अधिक जानने के लिए Help Center पर जाएँ>>
  
  डिफ़ॉल्ट रूप से, पैरामीटर false पर सेट है
  
  नोट: यदि true पर सेट है, तो प्रति टास्क शुल्क 2 गुना हो जाएगा
- depth
  टाइप: integer | null
  
  पार्सिंग गहराई
  
  वैकल्पिक फ़ील्ड
  
  SERP में परिणामों की संख्या
  
  डिफ़ॉल्ट मान: 10
  
  अधिकतम मान: 700
  
  आपके खाते से प्रत्येक ऐसे SERP के लिए बिल लिया जाएगा जिसमें अधिकतम 10 परिणाम हों;
  10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 10 से अधिक परिणाम लौटाता है;
  
  यदि निर्दिष्ट गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वचालित रूप से आपके खाता शेष में वापस कर दिया जाएगा;
  
  लागत की गणना Pricing पेज पर की जा सकती है।
- keyword
  टाइप: string
  
  कीवर्ड
  
  आवश्यक फ़ील्ड
  
  आप अधिकतम 700 अक्षर keyword फ़ील्ड में निर्दिष्ट कर सकते हैं
  
  सभी %## डिकोड किए जाएँगे (‘+’ अक्षर एक स्पेस अक्षर में डिकोड होगा)
  
  यदि आप अपने keyword के लिए “%” अक्षर का उपयोग करना चाहते हैं, तो इसे “%25” के रूप में निर्दिष्ट करें;
  
  यदि आप अपने keyword के लिए “+” अक्षर का उपयोग करना चाहते हैं, तो इसे “%2B” के रूप में निर्दिष्ट करें;
  
  यदि इस फ़ील्ड में ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’ जैसे पैरामीटर हैं, तो प्रति टास्क शुल्क 5 गुना हो जाएगा
  
  नोट: ‘cache:’ पैरामीटर वाली क्वेरीज़ समर्थित नहीं हैं और validation error लौटाएँगी
  
  DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में अधिक जानें
- language_code
  टाइप: string
  
  सर्च इंजन भाषा कोड
  
  language_name निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_name निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप language_code के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  en
- language_name
  टाइप: string
  
  सर्च इंजन भाषा का पूरा नाम
  
  language_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप language_name के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  English
- location_code
  टाइप: integer
  
  सर्च इंजन स्थान कोड
  
  location_name या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप location_code के साथ सर्च इंजनों के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  2840
- location_coordinate
  टाइप: string
  
  किसी स्थान के GPS निर्देशांक
  
  location_name या location_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_code निर्दिष्ट करने की आवश्यकता नहीं है
  
  location_coordinate पैरामीटर "latitude,longitude,radius" प्रारूप में निर्दिष्ट करना चाहिए
  
  "latitude" और "longitude" के लिए दशमलव अंकों की अधिकतम संख्या: 7
  
  "radius" के लिए न्यूनतम मान: 199.9 (mm)
  
  "radius" के लिए अधिकतम मान: 199999 (mm)
  
  उदाहरण:
  
  53.476225,-2.243572,200
- location_name
  टाइप: string
  
  सर्च इंजन स्थान का पूरा नाम
  
  location_code या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप location_name-सह सर्च इंजन के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  London,England,United Kingdom
- max_crawl_pages
  टाइप: integer | null
  
  पेज क्रॉल सीमा
  
  वैकल्पिक फ़ील्ड
  
  क्रॉल किए जाने वाले सर्च परिणाम पेजों की संख्या
  
  अधिकतम मान: 100
  
  नोट: max_crawl_pages और depth पैरामीटर एक-दूसरे के पूरक हैं;
  
  अधिक जानें हमारे Help Center पर
- os
  टाइप: string | null
  
  डिवाइस ऑपरेटिंग सिस्टम
  
  वैकल्पिक फ़ील्ड
  
  ध्यान दें कि यह API केवल डेस्कटॉप के लिए परिणाम देता है
  
  निम्न मानों में से चुनें: 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, html
- 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 पेज पर की जा सकती है।
- se_domain
  टाइप: string | null
  
  सर्च इंजन डोमेन
  
  वैकल्पिक फ़ील्ड
  
  हम आपके द्वारा निर्दिष्ट स्थान और भाषा के अनुसार प्रासंगिक सर्च इंजन डोमेन स्वचालित रूप से चुनते हैं
  
  हालाँकि, आप इस फ़ील्ड में कस्टम सर्च इंजन डोमेन सेट कर सकते हैं
  
  उदाहरण:
  
  google.co.uk, google.com.au, google.de, आदि
- search_param
  टाइप: string | null
  
  सर्च क्वेरी के अतिरिक्त पैरामीटर
  
  वैकल्पिक फ़ील्ड
  
  उपलब्ध पैरामीटरों की सूची और अतिरिक्त विवरण यहाँ प्राप्त करें
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  
  वैकल्पिक फ़ील्ड
  
  अक्षर सीमा 255 है
  
  आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
  
  आप निर्दिष्ट tag मान response के data ऑब्जेक्ट में पाएँगे
- url
  टाइप: string | null
  
  सर्च क्वेरी का सीधा URL
  
  वैकल्पिक फ़ील्ड
  
  आप सीधा URL निर्दिष्ट कर सकते हैं और हम इसे आवश्यक फ़ील्ड में वर्गीकृत कर देंगे;
  
  ध्यान दें कि यह विधि हमारे API के लिए संसाधित करने में सबसे कठिन है और इसके लिए URL में सटीक भाषा और स्थान निर्दिष्ट करना भी आवश्यक है। अधिकांश मामलों में, हम इस विधि का उपयोग करने की सलाह नहीं देते;
  
  उदाहरण:
  
  https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_SerpGoogleNewsTaskPostTaskInfo
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/news/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/news/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

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

{
  "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 News SERP टास्क सेट करना

प्रमाणीकरणRequired

DataForSEO

Google News SERP टास्क सेट करना

मूल्य संदर्भ