Felo API PlatformFelo API Platform
सभी DataForSEO endpoint
v0.2.0-beta
OpenAPI 3.1.0

लाइव ‘DataForSEO Trends Subregion Interests’ टास्क सेट करें

Felo API Support
MIT
सर्वर:https://openapi.felo.ai
क्लाइंट लाइब्रेरी
Shell Curl

DataForSEO

​

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

DataForSEO ऑपरेशन

लाइव ‘DataForSEO Trends Subregion Interests’ टास्क सेट करें

​

किसी कीवर्ड में रुचि कहाँ केंद्रित है, location_code के भीतर उपक्षेत्रों के हिसाब से। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request भी HTTP 200 ही लौटाता है। 'कौन' जानना हो, 'कहाँ' नहीं, तो post_dataforseo_keywords_trends_demography_live का उपयोग करें।

मूल्य संदर्भ

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

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

बॉडी
application/json
  • टाइप: array (object | null)[]
    • date_from
      टाइप: string | null

      समय सीमा की प्रारंभ तिथि
      वैकल्पिक फ़ील्ड
      यदि आप यह फ़ील्ड निर्दिष्ट नहीं करते हैं, तो डिफ़ॉल्ट रूप से पिछले वर्ष का वर्तमान दिन और महीना उपयोग होगा
      web प्रकार के लिए न्यूनतम मान: 2004-01-01
      अन्य प्रकारों के लिए न्यूनतम मान: 2008-01-01
      तिथि प्रारूप: "yyyy-mm-dd"
      उदाहरण:
      "2019-01-15"

    • date_to
      टाइप: string | null

      समय सीमा की समाप्ति तिथि
      वैकल्पिक फ़ील्ड
      यदि आप यह फ़ील्ड निर्दिष्ट नहीं करते हैं, तो डिफ़ॉल्ट रूप से आज की तिथि उपयोग होगी
      तिथि प्रारूप: "yyyy-mm-dd"
      उदाहरण:
      "2019-01-15"

    • keywords
      टाइप: array string[]

      कीवर्ड
      आवश्यक फ़ील्ड
      आप अधिकतम कितने कीवर्ड निर्दिष्ट कर सकते हैं: 5
      प्रतीकों और विशेष वर्णों (जैसे UTF प्रतीक, इमोजी) से बचें;
      गैर-लैटिन वर्ण निर्दिष्ट करने पर आपको उन देशों का डेटा मिलेगा जहाँ इनका उपयोग होता है

      DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में जानें

    • location_code
      टाइप: integer | null

      सर्च इंजन स्थान कोड
      वैकल्पिक फ़ील्ड
      यदि आप यह फ़ील्ड उपयोग नहीं करते हैं, तो आपको वैश्विक परिणाम मिलेंगे
      यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name निर्दिष्ट करने की आवश्यकता नहीं है
      आप location_code के साथ उपलब्ध सर्च इंजन स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      ध्यान दें कि डेटा उस देश के लिए प्रदान किया जाएगा जिससे निर्दिष्ट location_code संबंधित है;
      उदाहरण:
      2840

    • location_name
      टाइप: string | null

      सर्च इंजन स्थान का पूरा नाम
      वैकल्पिक फ़ील्ड
      यदि आप यह फ़ील्ड उपयोग नहीं करते हैं, तो आपको वैश्विक परिणाम मिलेंगे
      यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code निर्दिष्ट करने की आवश्यकता नहीं है
      आप location_name के साथ उपलब्ध सर्च इंजन स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      ध्यान दें कि डेटा उस देश के लिए प्रदान किया जाएगा जिससे निर्दिष्ट location_name संबंधित है;
      उदाहरण:
      United Kingdom

    • tag
      टाइप: string | null

      उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
      वैकल्पिक फ़ील्ड
      अक्षर सीमा 255 है
      आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
      निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

    • time_range
      टाइप: string | null

      प्रीसेट समय सीमाएँ
      वैकल्पिक फ़ील्ड
      यदि आप date_from या date_to पैरामीटर निर्दिष्ट करते हैं, तो टास्क सेट करते समय यह फ़ील्ड अनदेखा कर दिया जाएगा
      सभी type पैरामीटर के लिए संभावित मान:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      टाइप: string | null

      एलिमेंट का प्रकार

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

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

    • status_code
      टाइप: integer | null

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

    • status_message
      टाइप: string | null

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

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

      टास्क का ऐरे

      • टाइप: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo
        • 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

            कीवर्ड लोकप्रियता और संबंधित डेटा शामिल है

            • टाइप: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                • टाइप: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                  • type
                    डिस्क्रिमिनेटर
                    टाइप: string | null

                    एलिमेंट का प्रकार

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

                    प्रत्येक निर्दिष्ट शब्द के लिए उप-क्षेत्रीय कीवर्ड लोकप्रियता डेटा

                    • keyword
                      टाइप: string | null

                      प्रासंगिक कीवर्ड
                      values तत्व में शामिल डेटा इस कीवर्ड पर आधारित है

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

                      देश या क्षेत्र के अनुसार सापेक्ष कीवर्ड लोकप्रियता का डेटा शामिल है

                      • geo_id
                        टाइप: string | null

                        स्थान आइडेंटिफ़ायर
                        आप इस फ़ील्ड का उपयोग प्राप्त परिणामों को request में निर्दिष्ट स्थान पैरामीटर से मिलाने के लिए कर सकते हैं
                        उपलब्ध सभी स्थानों की सूची उनके geo_id के साथ यहाँ देखें या https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations पर अलग request भेजें
                        उदाहरण:
                        US-NY

                      • geo_name
                        टाइप: string | null

                        स्थान का नाम
                        आप इस फ़ील्ड का उपयोग प्राप्त परिणामों को request में निर्दिष्ट स्थान पैरामीटर से मिलाने के लिए कर सकते हैं
                        उपलब्ध सभी स्थानों की सूची उनके geo_name के साथ यहाँ देखें या https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations पर अलग request भेजें
                        उदाहरण:
                        Andorra

                      • value
                        टाइप: integer | null

                        किसी दिए गए स्थान में सापेक्ष कीवर्ड लोकप्रियता दर
                        निर्दिष्ट समय सीमा में स्थान-विशिष्ट कीवर्ड लोकप्रियता दर दर्शाता है;
                        इस value का उपयोग करके आप समझ सकते हैं कि कोई कीवर्ड एक स्थान में दूसरे स्थान की तुलना में कितना लोकप्रिय है;
                        गणना: हम सभी स्थानों में प्रासंगिक कीवर्ड के लिए उच्चतम लोकप्रियता मान निर्धारित करते हैं, फिर अन्य सभी मानों को उस उच्चतम मान (100) के प्रतिशत के रूप में व्यक्त करते हैं;
                        100 का मान इस शब्द की उच्चतम लोकप्रियता है
                        50 का मान इसका अर्थ है कि शब्द आधा लोकप्रिय है
                        0 का मान इसका अर्थ है कि इस शब्द के लिए पर्याप्त डेटा नहीं था

                  • interests_comparison
                    टाइप: object | null · Response36Afe1097B20_InterestsComparison

                    निर्दिष्ट पैरामीटर के लिए उप-क्षेत्रीय कीवर्ड लोकप्रियता पर डेटा की तुलना
                    यदि आपने एक ही कीवर्ड निर्दिष्ट किया है, तो मान null होगा

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

                      सभी स्थानों पर कीवर्ड लोकप्रियता दर
                      इस ऐरे में मान सभी स्थानों के अधिकतम मान के सापेक्ष प्रतिशत के रूप में हैं

                      • geo_id
                        टाइप: string | null

                        स्थान आइडेंटिफ़ायर
                        आप इस फ़ील्ड का उपयोग प्राप्त परिणामों को request में निर्दिष्ट स्थान पैरामीटर से मिलाने के लिए कर सकते हैं
                        उपलब्ध सभी स्थानों की सूची उनके geo_id के साथ यहाँ देखें या https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations पर अलग request भेजें
                        उदाहरण:
                        US-NY

                      • geo_name
                        टाइप: string | null

                        स्थान का नाम
                        आप इस फ़ील्ड का उपयोग प्राप्त परिणामों को request में निर्दिष्ट स्थान पैरामीटर से मिलाने के लिए कर सकते हैं
                        उपलब्ध सभी स्थानों की सूची उनके geo_name के साथ यहाँ देखें या https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations पर अलग request भेजें
                        उदाहरण:
                        Andorra

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

                        देश या क्षेत्र के अनुसार सापेक्ष कीवर्ड लोकप्रियता का डेटा शामिल है

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

                      कीवर्ड लोकप्रियता और संबंधित डेटा शामिल है

                      • geo_id
                        टाइप: string | null

                        स्थान आइडेंटिफ़ायर
                        आप इस फ़ील्ड का उपयोग प्राप्त परिणामों को request में निर्दिष्ट स्थान पैरामीटर से मिलाने के लिए कर सकते हैं
                        उपलब्ध सभी स्थानों की सूची उनके geo_id के साथ यहाँ देखें या https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations पर अलग request भेजें
                        उदाहरण:
                        US-NY

                      • geo_name
                        टाइप: string | null

                        स्थान का नाम
                        आप इस फ़ील्ड का उपयोग प्राप्त परिणामों को request में निर्दिष्ट स्थान पैरामीटर से मिलाने के लिए कर सकते हैं
                        उपलब्ध सभी स्थानों की सूची उनके geo_name के साथ यहाँ देखें या https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations पर अलग request भेजें
                        उदाहरण:
                        Andorra

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

                        देश या क्षेत्र के अनुसार सापेक्ष कीवर्ड लोकप्रियता का डेटा शामिल है

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

                    POST सरणी में कीवर्ड

                  • position
                    टाइप: integer | null

                    तत्व का संरेखण
                    निम्नलिखित मान ले सकता है: 1, 2, 3, 4 आदि

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

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

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

            POST सरणी में कीवर्ड

          • language_code
            टाइप: string | null

            POST सरणी में भाषा कोड
            यदि कोई डेटा नहीं है, तो मान null है

          • location_code
            टाइप: integer | null

            POST सरणी में स्थान कोड
            यदि कोई डेटा नहीं है, तो मान null है

          • 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
Request Example for post/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

सफल ऑपरेशन

Setting Live ‘DataForSEO Trends Subregion Interests’ Tasks