# id से ‘Ads Traffic By Keywords’ परिणाम प्राप्त करें

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}`

**Tags:** DataForSEO

`id` से कतार में लगे Google Ads ट्रैफ़िक पूर्वानुमान को प्राप्त करता है: आपके निर्दिष्ट बिड के लिए अनुमानित इम्प्रेशन, क्लिक, लागत और औसत स्थिति। DataForSEO के envelope में लिपटा: डेटा `tasks[0].result` में, परिणाम `tasks[0].status_code` में — अस्वीकृत request भी HTTP 200 ही लौटाता है। वॉल्यूम endpoints के विपरीत यह पूर्वानुमान है, माप नहीं — संख्याएँ `bid` और `match` के साथ बदलती हैं।

### मूल्य संदर्भ

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

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

## Related links

- [UUID](<https://en.wikipedia.org/wiki/Universally_unique_identifier>)
- [इस Help Center लेख](<https://dataforseo.com/help-center/configuring-bid>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string | <em>टास्क आइडेंटिफ़ायर</em><br><strong>हमारे सिस्टम में UUID प्रारूप में अद्वितीय टास्क आइडेंटिफ़ायर</strong><br>आप इसे <strong>30 दिनों</strong> के भीतर किसी भी समय टास्क के परिणाम माँगने के लिए उपयोग कर सकेंगे |

## Responses

### 200 — सफल ऑपरेशन

Headers:
- `X-Request-Id` (string) — Felo सहायता से संपर्क करते समय शामिल करने के लिए request पहचानकर्ता।

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo"
    }
  ]
}
```

### 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**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "API का वर्तमान संस्करण"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "सामान्य स्टेटस कोड\nresponse कोड की पूरी सूची यहाँ देखी जा सकती है"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "सामान्य सूचनात्मक संदेश\nसामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "कुल निष्पादन समय, सेकंड"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "टास्क की कुल लागत, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "tasks ऐरे में टास्क की संख्या",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "टास्क आइडेंटिफ़ायर\nहमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "टास्क का स्टेटस कोड\nDataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000\nresponse कोड की पूरी सूची यहाँ देखी जा सकती है"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "टास्क का सूचनात्मक संदेश\nसामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "निष्पादन समय, सेकंड"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "टास्क की कुल लागत, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "result ऐरे में एलिमेंट की संख्या",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "URL पथ"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे"
    }
  }
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo"
              }
            ]
          },
          "description": "<em>टास्क का ऐरे</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResultInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>POST सरणी में कीवर्ड</em><br>मेट्रिक POST सरणी में निर्दिष्ट सभी कीवर्ड के लिए प्रदान किए जाते हैं"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>POST सरणी में स्थान कोड</em><br>यदि कोई डेटा नहीं है, तो मान <code>null</code> है"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>POST सरणी में भाषा कोड</em><br>यदि कोई डेटा नहीं है, तो मान <code>null</code> है"
    },
    "date_interval": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>POST सरणी में पूर्वानुमान दिनांक अंतराल</em>"
    },
    "search_partners": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>Google सर्च पार्टनर शामिल करें</em><br>मान हमेशा <code>false</code> होता है"
    },
    "bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>अधिकतम कस्टम बिड</em><br>टास्क सेट करते समय आपके द्वारा निर्दिष्ट बिड<br>वह कीमत दर्शाता है जो आप विज्ञापन के लिए चुकाने को तैयार हैं<br>आप जितना अधिक मान निर्दिष्ट करेंगे, response में आपको उतने ही अधिक मेट्रिक और लागत मिलेंगे<br>इस Help Center लेख में और जानें"
    },
    "match": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>कीवर्ड मैच-प्रकार</em><br>निम्नलिखित मान ले सकता है: <code>exact</code>, <code>broad</code>, <code>phrase</code>"
    },
    "impressions": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>विज्ञापन इम्प्रेशन की अनुमानित संख्या</em><br>निर्दिष्ट समय अवधि में विज्ञापन को मिलने वाले इम्प्रेशन की अनुमानित संख्या<br><strong>नोट:</strong> पैरामीटर बहिष्कृत है, मान हमेशा <code>null</code> होता है"
    },
    "ctr": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>विज्ञापन का अनुमानित क्लिकथ्रू रेट (CTR)</em><br>विज्ञापन को मिलने वाले क्लिक की अनुमानित संख्या को विज्ञापन इम्प्रेशन की संख्या से विभाजित करके;<br><strong>नोट:</strong> पैरामीटर बहिष्कृत है, मान हमेशा <code>null</code> होता है",
      "format": "double"
    },
    "average_cpc": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>औसत प्रति क्लिक लागत मान</em><br>निर्दिष्ट समय अवधि और ऐतिहासिक डेटा के आधार पर कीवर्ड के लिए अनुमानित प्रति क्लिक लागत (USD) दर्शाता है;<br>यदि कोई डेटा नहीं है, तो मान <code>null</code> है",
      "format": "double"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>विज्ञापन के लिए शुल्क</em><br>निर्दिष्ट समय अवधि में विज्ञापन चलाने के लिए लिया जाने वाला शुल्क<br>यदि कोई डेटा नहीं है, तो मान <code>null</code> है"
    },
    "clicks": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>विज्ञापन पर क्लिक की संख्या</em><br>निर्दिष्ट समय अवधि में विज्ञापन को मिलने वाले क्लिक की अनुमानित संख्या<br>यदि कोई डेटा नहीं है, तो मान <code>null</code> है"
    }
  }
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResultInfo"
              }
            ]
          },
          "description": "<em>परिणामों का ऐरे</em>"
        }
      }
    }
  ]
}
```
