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

लाइव ‘DataForSEO Trends Merged Data’ टास्क सेट करें

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 Merged Data’ टास्क सेट करें

​

उन्हीं keywords के लिए Explore, जनसांख्यिकी और उपक्षेत्र डेटा एक ही response में, तीन अलग कॉल के बजाय। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request भी HTTP 200 ही लौटाता है। जब पूरी तस्वीर चाहिए तो इसे प्राथमिकता दें: तीनों सहोदरों में से प्रत्येक एक कॉल का खर्च है, और यह वह सब लौटाता है जो तीनों मिलकर लौटाते।

मूल्य संदर्भ

  • मीटरिंग: रिपोर्ट किया गया response लागत
  • संदर्भ request अनुमान: USD 0.09
  • संदर्भ ग्राहक गुणक: 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_KeywordsDataDataforseoTrendsMergedDataLiveResponseInfo
    • cost
      टाइप: number | null फ़ॉर्मेट: double

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

    • status_code
      टाइप: integer | null

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

    • status_message
      टाइप: string | null

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

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

      टास्क का ऐरे

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

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

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

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

            • position
              टाइप: integer | null

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

            • type
              टाइप: string | null

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

          • 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/merged_data/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/merged_data/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": null,
              "position": null,
              "keywords": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

सफल ऑपरेशन

Setting Live ‘DataForSEO Trends Merged Data’ Tasks