लाइव Google Organic SERP HTML

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/organic/live/html

लाइव Google Organic SERP HTML

Google पर किसी कीवर्ड के रैंक किए गए परिणाम सिंक्रोनस रूप से लौटाता है। पार्स किए गए परिणामों के बजाय कच्चा पेज सोर्स। 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)[]
- depth
  टाइप: integer | null
  
  पार्सिंग गहराई
  
  वैकल्पिक फ़ील्ड
  
  SERP में परिणामों की संख्या
  
  डिफ़ॉल्ट मान: 10
  
  अधिकतम मान: 200
  
  आपके खाते से प्रत्येक ऐसे SERP के लिए बिल लिया जाएगा जिसमें अधिकतम 10 परिणाम हों;
  10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 10 से अधिक परिणाम लौटाता है;
  
  लागत की गणना Pricing पेज पर की जा सकती है।
- device
  टाइप: string | null
  
  डिवाइस प्रकार
  
  वैकल्पिक फ़ील्ड
  
  किसी विशेष डिवाइस प्रकार के लिए परिणाम लौटाएँ
  
  यह निम्न मान ले सकता है:desktop, mobile
  
  डिफ़ॉल्ट मान: desktop
- expand_ai_overview
  टाइप: boolean | null
  
  AI overview का विस्तार करें
  
  वैकल्पिक फ़ील्ड
  
  ai_overview आइटम का विस्तार करने के लिए true पर सेट करें;
  
  डिफ़ॉल्ट मान: false
- find_targets_in
  टाइप: array string[] | null
  
  SERP एलिमेंट प्रकार जिन्हें टारगेट के लिए जाँचना है
  
  वैकल्पिक फ़ील्ड
  
  इस पैरामीटर को सक्षम करने के लिए, stop_crawl_on_match भी सक्षम होना चाहिए
  
  निर्दिष्ट करता है कि किन SERP एलिमेंट प्रकारों को टारगेट मैच के लिए जाँचना चाहिए
  
  यदि निर्दिष्ट नहीं है, तो url और domain फ़ील्ड वाले सभी प्रथम-स्तरीय एलिमेंट टारगेट के लिए जाँचे जाते हैं
  
  संभावित मान: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
  
  नोट: इसमें ignore_targets_in के समान एलिमेंट प्रकार नहीं हो सकते
  
  उदाहरण:
  
  "find_targets_in": ["organic", "featured_snippet"]
  
  इस पैरामीटर के बारे में हमारे Help Center पर अधिक जानें
- ignore_targets_in
  टाइप: array string[] | null
  
  टारगेट खोज से बाहर रखे जाने वाले SERP एलिमेंट प्रकार
  
  वैकल्पिक फ़ील्ड
  
  इस पैरामीटर को सक्षम करने के लिए, stop_crawl_on_match भी सक्षम होना चाहिए
  
  निर्दिष्ट करता है कि टारगेट मैच खोजते समय किन SERP एलिमेंट प्रकारों को बाहर रखा जाना चाहिए
  
  संभावित मान: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
  
  नोट: इसमें find_targets_in के समान एलिमेंट प्रकार नहीं हो सकते
  
  उदाहरण:
  
  "ignore_targets_in": ["paid", "images"]
  
  इस पैरामीटर के बारे में हमारे Help Center पर अधिक जानें
- keyword
  टाइप: string
  
  कीवर्ड
  
  आवश्यक फ़ील्ड
  
  आप अधिकतम 700 अक्षर keyword फ़ील्ड में निर्दिष्ट कर सकते हैं
  
  सभी %## डिकोड किए जाएँगे ('+' अक्षर एक स्पेस अक्षर में डिकोड होगा)
  
  यदि आप अपने keyword के लिए "%" अक्षर का उपयोग करना चाहते हैं, तो इसे "%25" के रूप में निर्दिष्ट करें;
  
  यदि आप अपने keyword के लिए “+” अक्षर का उपयोग करना चाहते हैं, तो इसे “%2B” के रूप में निर्दिष्ट करें;
  
  यदि इस फ़ील्ड में 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:' जैसे पैरामीटर हैं, तो प्रति टास्क शुल्क 5 गुना हो जाएगा
- language_code
  टाइप: string
  
  सर्च इंजन भाषा कोड
  
  language_name निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_name निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप language_code -सह सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/google/languages पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  en
- language_name
  टाइप: string
  
  सर्च इंजन भाषा का पूरा नाम
  
  language_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप language_name-सह सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/google/languages पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  English
- load_async_ai_overview
  टाइप: boolean | null
  
  AI overview को एसिंक्रोनस रूप से लोड करें
  
  वैकल्पिक फ़ील्ड
  
  ai_overview आइटम प्राप्त करने के लिए true पर सेट करें, भले ही वे SERP में एसिंक्रोनस रूप से लोड हों;
  
  यदि false पर सेट किया जाता है, तो आपको केवल कैश से ai_overview आइटम मिलेंगे;
  
  डिफ़ॉल्ट मान: false
  
  नोट प्रत्येक request के लिए आपके खाते से अतिरिक्त $0.002 बिल लिया जाएगा;
  
  यदि एलिमेंट अनुपस्थित है या उसमें "asynchronous_ai_overview": false है, तो सभी अतिरिक्त शुल्क आपके खाता शेष में वापस कर दिए जाएँगे
- location_code
  टाइप: integer
  
  सर्च इंजन स्थान कोड
  
  आवश्यक फ़ील्ड यदि आप location_name या location_coordinate निर्दिष्ट नहीं करते
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप location_code-सह सर्च इंजनों के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/google/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 (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/google/locations पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  London,England,United Kingdom
- match_type
  टाइप: string
  
  टारगेट मैच प्रकार
  
  आवश्यक फ़ील्ड यदि stop_crawl_on_match निर्दिष्ट है
  
  match_value के लिए मैच का प्रकार
  
  संभावित मान:
  
  domain – विशिष्ट डोमेन या सबडोमेन
  
  with_subdomains – मुख्य डोमेन और सबडोमेन
  
  wildcard – वाइल्डकार्ड पैटर्न
- match_value
  टाइप: string
  
  टारगेट डोमेन, सबडोमेन या वाइल्डकार्ड मान
  
  आवश्यक फ़ील्ड यदि stop_crawl_on_match निर्दिष्ट है
  
  टारगेट डोमेन, सबडोमेन या वाइल्डकार्ड मान निर्दिष्ट करें;
  
  नोट: डोमेन या सबडोमेन request प्रोटोकॉल के बिना निर्दिष्ट करना चाहिए;
  
  उदाहरण: "match_value": "dataforseo.com",
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  टाइप: integer | null
  
  पेज क्रॉल सीमा
  
  वैकल्पिक फ़ील्ड
  
  क्रॉल किए जाने वाले सर्च परिणाम पेजों की संख्या
  
  अधिकतम मान: 100
  
  नोट: क्रॉल किए गए प्रत्येक पेज के लिए आपसे शुल्क लिया जाएगा (प्रति पेज 10 ऑर्गेनिक परिणाम);
  
  हमारे Pricing पेज पर मूल्य निर्धारण के बारे में अधिक जानें;
  
  नोट#2: max_crawl_pages और depth पैरामीटर एक-दूसरे के पूरक हैं;
  
  अधिक जानें हमारे help center पर
- os
  टाइप: string | null
  
  डिवाइस ऑपरेटिंग सिस्टम
  
  वैकल्पिक फ़ील्ड
  
  यदि आप device फ़ील्ड में desktop निर्दिष्ट करते हैं, तो निम्न में से चुनें: windows, macos
  
  डिफ़ॉल्ट मान: windows
  
  यदि आप device फ़ील्ड में mobile निर्दिष्ट करते हैं, तो निम्न में से चुनें: android, ios
  
  डिफ़ॉल्ट मान: android
- se_domain
  टाइप: string | null
  
  सर्च इंजन डोमेन
  
  वैकल्पिक फ़ील्ड
  
  हम आपके द्वारा निर्दिष्ट स्थान और भाषा के अनुसार प्रासंगिक सर्च इंजन डोमेन स्वचालित रूप से चुनते हैं
  
  हालाँकि, आप इस फ़ील्ड में कस्टम सर्च इंजन डोमेन सेट कर सकते हैं
  
  उदाहरण:
  
  google.co.uk, google.com.au, google.de, आदि
- search_param
  टाइप: string | null
  
  सर्च क्वेरी के अतिरिक्त पैरामीटर
  
  वैकल्पिक फ़ील्ड
  
  उपलब्ध पैरामीटरों की सूची और अतिरिक्त विवरण यहाँ प्राप्त करें
  
  नोट: निम्न सर्च इंजन पैरामीटर समर्थित नहीं हैं और यदि निर्दिष्ट किए जाते हैं तो स्वचालित रूप से अनसेट हो जाएँगे: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stop_crawl_on_match
  टाइप: array (object | null)[] | null
  
  क्रॉलिंग रोकने के लिए टार्गेट का ऐरे वैकल्पिक फ़ील्ड यदि निर्दिष्ट किया जाए, तो response में निर्दिष्ट match_value तक और उसके सहित SERP परिणाम होंगे; आप इस ऐरे में अधिकतम 10 टार्गेट मान निर्दिष्ट कर सकते हैं उदाहरण: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] इस पैरामीटर के बारे में हमारे Help Center पर और जानें - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api आपके खाते से निर्दिष्ट टार्गेट के माध्यम से क्रॉल किए गए प्रत्येक SERP के लिए बिल लिया जाएगा
  
  match_type
  टाइप: string | null
  
  टार्गेट मैच प्रकार stop_crawl_on_match निर्दिष्ट होने पर आवश्यक फ़ील्ड; match_value के लिए मैच का प्रकार संभावित मान: domain, with_subdomains, wildcard
  
  match_value
  टाइप: string | null
  
  टार्गेट डोमेन या वाइल्डकार्ड मान stop_crawl_on_match निर्दिष्ट होने पर आवश्यक फ़ील्ड; टार्गेट डोमेन या वाइल्डकार्ड मान निर्दिष्ट करें; नोट: डोमेन नाम request प्रोटोकॉल के बिना निर्दिष्ट करना होगा; उदाहरण: dataforseo.com
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  
  वैकल्पिक फ़ील्ड
  
  अक्षर सीमा 255 है
  
  आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
  
  आप निर्दिष्ट tag मान response के data ऑब्जेक्ट में पाएँगे
- target_search_mode
  टाइप: string | null
  
  टार्गेट मैचिंग मोड
  
  वैकल्पिक फ़ील्ड
  
  इस पैरामीटर को सक्षम करने के लिए stop_crawl_on_match भी सक्षम होना चाहिए
  
  यह निर्धारित करता है कि stop_crawl_on_match में कई टार्गेट निर्दिष्ट होने पर क्रॉल कैसे रुके
  
  संभावित मान: all, any
  
  all – क्रॉल तभी रुकता है जब सभी निर्दिष्ट टार्गेट मिल जाते हैं
  
  any – क्रॉल तब रुकता है जब कोई एक टार्गेट मिल जाता है
  
  डिफ़ॉल्ट मान: any
  
  इस पैरामीटर के बारे में Help Center पर और जानें
- url
  टाइप: string | null
  
  सीधा खोज URL
  
  वैकल्पिक फ़ील्ड
  
  आप सीधा URL निर्दिष्ट कर सकते हैं और हम उसे आवश्यक फ़ील्ड में पार्स करेंगे। ध्यान दें कि यह तरीका हमारे API के लिए संसाधित करना सबसे कठिन है और इसके लिए URL में भाषा और स्थान का सही मिलान होना भी आवश्यक है। ज़्यादातर मामलों में हम इस तरीके का उपयोग करने की सलाह नहीं देते
  
  उदाहरण:
  
  https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
  
  नोट: निम्नलिखित सर्च इंजन पैरामीटर समर्थित नहीं हैं और URL में निर्दिष्ट किए जाने पर स्वचालित रूप से अनसेट हो जाएँगे: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

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

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

data
टाइप: object | null

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

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

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

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

URL पथ

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

परिणामों का ऐरे

datetime
टाइप: string | null

वह तारीख और समय जब परिणाम प्राप्त हुआ
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”
उदाहरण:
2019-11-15 12:57:46 +00:00

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

SERP में मिले सर्च परिणामों के तत्व

date
टाइप: string | null

वह तारीख और समय जब HTML पेज स्कैन किया गया
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”
उदाहरण:
2019-11-15 12:57:46 +00:00

html
टाइप: string | null

HTML पेज

page
टाइप: integer | null

लौटाए गए HTML पेज की क्रम संख्या

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

items ऐरे में लौटाए गए परिणामों की संख्या

keyword
टाइप: string | null

POST ऐरे में प्राप्त कीवर्ड
कीवर्ड डिकोड किए गए %## के साथ लौटाया जाता है ('+' वर्ण एक स्पेस में डिकोड होता है)

language_code
टाइप: string | null

POST ऐरे में भाषा कोड

location_code
टाइप: integer | null

POST ऐरे में स्थान कोड

se_domain
टाइप: string | null

POST ऐरे में सर्च इंजन डोमेन

type
टाइप: string | 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/organic/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html \
  --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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

सफल ऑपरेशन

लाइव Google Organic SERP HTML

प्रमाणीकरणRequired

DataForSEO

लाइव Google Organic SERP HTML

मूल्य संदर्भ