DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
कंटेंट विश्लेषण – सर्च API
कीवर्ड का उद्धरण देने वाले अलग-अलग पेजों की सूची देता है, कुल संख्या नहीं। हर आइटम में url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score और page_category के साथ total_count और items_count होते हैं। filters उन फ़ील्ड को स्वीकार करता है जो get_dataforseo_content_available_filters सूचीबद्ध करता है। पेजों के बजाय गणना और वितरण के लिए post_dataforseo_content_summary_live का उपयोग करें।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट की गई response लागत
- संदर्भ request अनुमान: USD 0.0276
- संदर्भ ग्राहक गुणक: 1.0। पहले से निपटाई गई ग्राहक राशि पर इसे दोबारा न लगाएँ
केवल संदर्भ मेटाडेटा, कोई खाता कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। संसाधन क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगाए जाते हैं।
- टाइप: array (object | null)[]
- filtersटाइप: array (object | null)[] | null
परिणाम फ़िल्टरिंग पैरामीटर की सरणी
वैकल्पिक फ़ील्ड
एक साथ कई फ़िल्टर जोड़ सकते हैं (अधिकतम 8 फ़िल्टर)
शर्तों के बीचand,orलॉजिकल ऑपरेटर सेट करना चाहिए
निम्नलिखित ऑपरेटर समर्थित हैं:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,match,not_match
शून्य या अधिक अक्षरों वाले किसी भी स्ट्रिंग से मिलान के लिए%ऑपरेटर कोlikeऔरnot_likeके साथ उपयोग कर सकते हैं
उदाहरण:["country","=", "US"][["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]][["domain_rank",">",800],
"and",
[["page_types","has","ecommerce"],
"or",["content_info.text_category","has",10994]]]
फ़िल्टर के बारे में अधिक जानकारी के लिए Content Analysis API - Filters देखेंखाली ऑब्जेक्ट - keywordटाइप: string
लक्षित कीवर्ड
आवश्यक फ़ील्ड
UTF-8 एन्कोडिंग
कीवर्ड को lowercase प्रारूप में बदल दिया जाएगा;
नोट: अकेले कीवर्ड के बजाय सटीक वाक्यांश से मिलान करने के लिए डबल कोट्स और बैकस्लैश उपयोग करें;
उदाहरण:"keyword": "\"tesla palo alto\""DataForSEO API में
keywordऔरkeywordsफ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में और जानें - keywordटाइप: object | null
_fields लक्षित कीवर्ड फ़ील्ड और लक्षित कीवर्ड
वैकल्पिक फ़ील्ड
इस पैरामीटर से डेटासेट को उन कीवर्ड के अनुसार फ़िल्टर करें जो कुछ फ़ील्ड में होने चाहिए;
आप जो फ़ील्ड निर्दिष्ट कर सकते हैं:title,main_title,previous_title,snippet
आप कई फ़ील्ड संकेत कर सकते हैं;
नोट: अकेले कीवर्ड के बजाय सटीक वाक्यांश से मिलान करने के लिए डबल कोट्स और बैकस्लैश उपयोग करें;
उदाहरण:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- propertyटाइप: string | null
Name
- limitटाइप: integer | null
लौटाए जाने वाले साइटेशन की अधिकतम संख्या
वैकल्पिक फ़ील्ड
डिफ़ॉल्ट मान:100
अधिकतम मान:1000 - offsetटाइप: integer | null
लौटाए गए साइटेशन की परिणाम सरणी में ऑफ़सेट
वैकल्पिक फ़ील्ड
डिफ़ॉल्ट मान:0
यदि आप10मान निर्दिष्ट करते हैं, तो परिणाम सरणी में पहले दस साइटेशन छोड़ दिए जाएँगे और डेटा अगले साइटेशन के लिए दिया जाएगा
नोट: यह पैरामीटर केवल 10,000 तक परिणाम प्राप्त करते समय उपयोग करने की सलाह देते हैं
10,000 से अधिक परिणाम प्राप्त करने के लिए इसके बजायoffset_tokenउपयोग करें। - offsetटाइप: string | null
_token बाद के रिक्वेस्ट के लिए ऑफ़सेट टोकन
वैकल्पिक फ़ील्ड
प्रत्येक रिक्वेस्ट के response के उसी फ़ील्ड में प्रदान किया जाता है;
एक ही रिक्वेस्ट में 10,000 से अधिक परिणाम प्राप्त करते समय टाइमआउट से बचने के लिए इस पैरामीटर का उपयोग करें;
response सरणी से अद्वितीयoffset_tokenमान निर्दिष्ट करके आप प्रारंभिक टास्क के बाद के परिणाम प्राप्त करेंगे;offset_tokenमान प्रत्येक बाद के टास्क के लिए अद्वितीय होते हैं
नोट: यदि रिक्वेस्ट मेंoffset_tokenनिर्दिष्ट है, तो टास्क संसाधित करते समयlimitके अतिरिक्त सभी पैरामीटर पर ध्यान नहीं दिया जाएगा
इस पैरामीटर के बारे में हमारे Help Center पर और जानें - orderटाइप: array string[] | null
_by परिणाम सॉर्टिंग नियम
वैकल्पिक फ़ील्ड
परिणाम सॉर्ट करने के लिएfiltersसरणी जैसे ही मान उपयोग कर सकते हैं
संभावित सॉर्टिंग प्रकार:asc- परिणाम आरोही क्रम में सॉर्ट किए जाएँगेdesc- परिणाम अवरोही क्रम में सॉर्ट किए जाएँगे
सॉर्टिंग प्रकार सेट करने के लिए कॉमा उपयोग करना चाहिए
उदाहरण:["content_info.sentiment_connotations.anger,desc"]
डिफ़ॉल्ट नियम:["content_info.sentiment_connotations.anger,desc"]
ध्यान दें कि एक ही रिक्वेस्ट में तीन से अधिक सॉर्टिंग नियम सेट नहीं कर सकते
कई सॉर्टिंग नियमों को अलग करने के लिए कॉमा उपयोग करना चाहिए
उदाहरण:["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"] - pageटाइप: array string[] | null
_type लक्षित पेज प्रकार
वैकल्पिक फ़ील्ड
इस पैरामीटर से डेटासेट को पेज प्रकार के अनुसार फ़िल्टर करें
संभावित मान:"ecommerce","news","blogs","message-boards","organization" - rankटाइप: string | null
_scale domain_rankऔरurl_rankमानों की गणना और प्रदर्शन में उपयोग होने वाले स्केल को परिभाषित करता है
वैकल्पिक फ़ील्डइस पैरामीटर से चुन सकते हैं कि रैंक मान 0–100 या 0–1000 स्केल पर प्रस्तुत किए जाएँ
संभावित मान:
one_hundred— रैंक मान 0–100 स्केल पर प्रदर्शित होते हैंone_thousand— रैंक मान 0–1000 स्केल पर प्रदर्शित होते हैंडिफ़ॉल्ट मान:
one_thousandयह पैरामीटर कैसे काम करता है, इसके बारे में इस Help Center लेख में और जानें
- searchटाइप: string | null
_mode परिणाम समूहीकरण प्रकार
वैकल्पिक फ़ील्ड
संभावित समूहीकरण प्रकार:as_is- लक्षितkeywordके सभी साइटेशन लौटाता हैone_per_domain- प्रति डोमेनkeywordका एक साइटेशन लौटाता है
डिफ़ॉल्ट मान:as_is - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा
- टाइप: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- propertyटाइप: object | null
Name
- idटाइप: string | null
टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में
- pathटाइप: array (string | null)[] | null
URL पथ
- resultटाइप: array (object | null)[] | null
परिणामों का ऐरे
- itemsटाइप: array (object | null)[] | null
उद्धरण और संबंधित डेटा शामिल हैं
- contentटाइप: object | null · Response36Afe1097B20_AnalysisContentInfo
_info दिए गए
urlसे उद्धरणों पर डेटा शामिल है- authorटाइप: string | null
सामग्री के लेखक
- connotationटाइप: object | null
_types कॉनोटेशन प्रकार
दिए गए साइटेशन से संबंधित भावनाओं (सेंटिमेंट पोलैरिटी) के प्रकार और प्रत्येक सेंटिमेंट प्रकार के लिए प्रायिकता सूचकांक शामिल हैं
संभावित सेंटिमेंट कॉनोटेशन प्रकार:positive,negative,neutral- propertyटाइप: integer | null फ़ॉर्मेट: int64
Name Signed 64-bit integers (long type).
- contentटाइप: integer | null
_quality _score सामग्री गुणवत्ता स्कोर
यह मान सामग्री में मौजूद शब्दों, वाक्यों और अक्षरों की संख्या के आधार पर गणना किया जाता है - contentटाइप: string | null
_type सामग्री का प्रकार
उदाहरण:page_content,comment - dateटाइप: string | null
_published वह दिनांक और समय जब सामग्री प्रकाशित हुई
UTC प्रारूप में: "yyyy-mm-dd hh-mm-ss +00:00"
उदाहरण:2017-01-24 13:20:59 +00:00 - groupटाइप: string | null
_date साइटेशन समूह का दिनांक और समय
सामग्री प्रकाशन की तारीख या वह तारीख और समय बताता है जब हमारे क्रॉलर ने पहली बार पेज देखा;
इस फ़ील्ड का उपयोग साइटेशन को तारीख के अनुसार समूहित करने और साइटेशन रुझान दिखाने के लिए किया जा सकता है;
तारीख और समय UTC प्रारूप में दिए जाते हैं: "yyyy-mm-dd hh-mm-ss +00:00"
उदाहरण:2017-01-24 13:20:59 +00:00 - highlightedटाइप: string | null
_text snippetसे हाइलाइट किया गया टेक्स्ट - languageटाइप: string | null
- levelटाइप: integer | null
titleहेडिंग स्तर1(शीर्ष) से6(तल) तक h-टैग स्तर बताता है - mainटाइप: string | null
_title पेज शीर्षक
- previousटाइप: string | null
_title पिछले कंटेंट ब्लॉक का शीर्षक
- ratingटाइप: object | null · Response36Afe1097B20_ContententRatingInfo
सामग्री रेटिंग
content_infoसे संबंधित रेटिंग- maxटाइप: number | null फ़ॉर्मेट: double
_rating _value रेटिंग नाम के लिए अधिकतम मान
- nameटाइप: string | null
रेटिंग नाम यहाँ आपको निम्न तत्व मिलेंगे: Max5, Percents, CustomMax
- ratingटाइप: integer | null फ़ॉर्मेट: int64
_count वोटों की संख्या
- ratingटाइप: number | null फ़ॉर्मेट: double
_value रेटिंग का मान
- relativeटाइप: number | null फ़ॉर्मेट: double
_rating सापेक्ष रेटिंग
- semanticटाइप: string | null
_location सिमैंटिक स्थान
HTML में वह सिमैंटिक तत्व बताता है जहाँ लक्षित कीवर्ड साइटेशन स्थित है
उदाहरण:article,header - sentimentटाइप: object | null
_connotations सेंटिमेंट कॉनोटेशन
दिए गए साइटेशन से संबंधित भावनाएँ (भावनात्मक प्रतिक्रियाएँ) और प्रत्येक सेंटिमेंट के लिए प्रायिकता सूचकांक शामिल हैं
संभावित सेंटिमेंट कॉनोटेशन:anger,happiness,love,sadness,share,fun- propertyटाइप: integer | null फ़ॉर्मेट: int64
Name Signed 64-bit integers (long type).
- snippetटाइप: string | null
सामग्री स्निपेट
- snippetटाइप: integer | null
_length स्निपेट की अक्षर लंबाई
- socialटाइप: array (object | null)[] | null
_metrics सोशल मीडिया एंगेजमेंट मेट्रिक्स
सोशल मीडिया प्लेटफ़ॉर्म द्वारा विकसित और समर्थित वेबसाइट embeds के आधार पर कंटेंट से जुड़े सोशल मीडिया इंटरैक्शन पर डेटा- likeटाइप: integer | null फ़ॉर्मेट: int64
_count लाइक की संख्या
- typeटाइप: string | null
एलिमेंट का प्रकार
- textटाइप: array integer[] | null
_category - titleटाइप: string | null
परिणाम का शीर्षक
- countryटाइप: string | null
- domainटाइप: string | null
डोमेन नाम
- domainटाइप: integer | null
_rank domainका रैंक
यह मान DataForSEO Backlink Index से दिए गए डोमेन के बैकलिंक डेटा पर आधारित है;domain_rankलिंक किए गए डेटाबेस में नोड रैंकिंग की विधि पर आधारित है – यही सिद्धांत मूल Google PageRank एल्गोरिदम में उपयोग किया गया था
मेट्रिक और इसकी गणना के तरीके के बारे में इस Help Center लेख में और जानें - fetchटाइप: string | null
_time वह तारीख और समय जब हमारे क्रॉलर ने पेज का दौरा किया
UTC प्रारूप में: "yyyy-mm-dd hh-mm-ss +00:00"
उदाहरण:2017-01-24 13:20:59 +00:00 - languageटाइप: string | null
- mainटाइप: string | null
_domain मुख्य डोमेन
- pageटाइप: array integer[] | null
_category - pageटाइप: array string[] | null
_types पेज प्रकार
- ratingsटाइप: array (object | null)[] | null
पेज पर मिली रेटिंग
माइक्रोडेटा के आधार पर पेज पर मिली सभी रेटिंग- maxटाइप: number | null फ़ॉर्मेट: double
_rating _value रेटिंग नाम के लिए अधिकतम मान
- nameटाइप: string | null
रेटिंग नाम यहाँ आपको निम्न तत्व मिलेंगे: Max5, Percents, CustomMax
- ratingटाइप: integer | null फ़ॉर्मेट: int64
_count वोटों की संख्या
- ratingटाइप: number | null फ़ॉर्मेट: double
_value रेटिंग का मान
- relativeटाइप: number | null फ़ॉर्मेट: double
_rating सापेक्ष रेटिंग
- scoreटाइप: number | null
उद्धरण प्रमुखता स्कोर
यह मानurl_rank,domain_rankतथाkeywordकीtitle,main_title,urlऔरsnippetमें उपस्थिति पर आधारित हैscoreजितना अधिक होगा, संबंधित उद्धरण का मूल्य उतना ही अधिक होगा - socialटाइप: array (object | null)[] | null
_metrics सोशल मीडिया एंगेजमेंट मेट्रिक्स
सोशल मीडिया प्लेटफ़ॉर्म द्वारा विकसित और समर्थित वेबसाइट embeds के आधार पर कंटेंट से जुड़े सोशल मीडिया इंटरैक्शन पर डेटा- likeटाइप: integer | null फ़ॉर्मेट: int64
_count लाइक की संख्या
- typeटाइप: string | null
एलिमेंट का प्रकार
- spamटाइप: integer | null
_score - typeटाइप: string | null
एलिमेंट का प्रकार
- urlटाइप: string | null
वह URL जहाँ उद्धरण मिला
- urlटाइप: integer | null
_rank
- itemsटाइप: integer | null फ़ॉर्मेट: int64
_count itemsऐरे में लौटाए गए परिणामों की संख्या - offsetटाइप: string | null
_token बाद के request के लिए ऑफ़सेट टोकन
प्रारंभिक टास्क के बाद के परिणाम प्राप्त करने के लिए आप इस फ़ील्ड में दिया गया स्ट्रिंग उपयोग कर सकते हैं;
नोट:offset_tokenमान प्रत्येक बाद के टास्क के लिए अद्वितीय होते हैं - totalटाइप: integer | null फ़ॉर्मेट: int64
_count आपके request से संबंधित हमारे डेटाबेस में परिणामों की कुल संख्या
- resultटाइप: integer | null फ़ॉर्मेट: int64
_count result ऐरे में एलिमेंट की संख्या
- statusटाइप: integer | null
_code टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है
- statusटाइप: string | null
_message टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- timeटाइप: string | null
निष्पादन समय, सेकंड
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_count tasks ऐरे में टास्क की संख्या
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_error त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या
- टाइप: string | nulltime
कुल निष्पादन समय, सेकंड
- टाइप: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword_fields": {
"snippet": "logitech"
},
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"search_mode": "as_is",
"filters": [
"main_domain",
"=",
"reviewfinder.ca"
],
"order_by": [
"content_info.sentiment_connotations.anger,desc"
],
"limit": 10
}
]'
{
"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": [
{
"offset_token": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"url": null,
"domain": null,
"main_domain": null,
"url_rank": null,
"spam_score": null,
"domain_rank": null,
"fetch_time": null,
"country": null,
"language": null,
"score": null,
"page_category": [
"[Max Depth Exceeded]"
],
"page_types": [
"[Max Depth Exceeded]"
],
"ratings": [
"[Max Depth Exceeded]"
],
"social_metrics": [
"[Max Depth Exceeded]"
],
"content_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}