# لائیو Gemini LLM Scraper ایڈوانسڈ

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/gemini/llm_scraper/live/advanced`

**Tags:** DataForSEO

Gemini سے ایک `keyword` ایسے پوچھتا ہے جیسے کوئی صارف پوچھتا، اور پارس شدہ جواب واپس کرتا ہے۔ `keyword`، `location_code`، `language_code`، `model`، `datetime`، `markdown`، `sources`، `se_results_count`، `item_types`، `items_count` اور `items` واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا `tasks[0].result` میں، نتیجہ `tasks[0].status_code` میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ اس کا ChatGPT ہم منصب `post_dataforseo_ai_chat_gpt_llm_scraper_live` ہے؛ دونوں کو چلا کر موازنہ کرنا اسی فیملی کا مقصد ہے۔

### قیمت کا حوالہ

- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.701۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

## Related links

- [Help Center مضمون](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [مارک ڈاؤن مارک اپ زبان](<https://en.wikipedia.org/wiki/Markdown>)

## Base URL

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

## Authentication

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

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string",
            "description": "<em>کی ورڈ</em><br><strong>درکار فیلڈ</strong><br>آپ <code>keyword</code> فیلڈ میں <strong>زیادہ سے زیادہ 2000 حروف</strong> متعین کر سکتے ہیں<br>تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف خالی جگہ کے حرف میں ڈی کوڈ ہوگا)<br>اگر آپ کو اپنے <code>keyword</code> کے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں؛<br>اگر آپ کو اپنے <code>keyword</code> کے لیے “+” حرف استعمال کرنا ہو تو اسے “%2B” کے طور پر متعین کریں<p>DataForSEO APIs میں <code>keyword</code> اور <code>keywords</code> فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں"
          },
          "location_name": {
            "type": "string",
            "description": "<em>سرچ انجن مقام کا پورا نام</em><br><strong>اگر آپ <code>location_code</code> یا <code>location_coordinate</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>location_code</code> یا <code>location_coordinate</code> متعین کرنے کی ضرورت نہیں</strong><br>آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے <code>location_name</code> کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: <code>https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations</code><br>مثال:<br><code class=\"long-string\">United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>سرچ انجن مقام کا کوڈ</em><br><strong>اگر آپ <code>location_name</code> یا <code>location_coordinate</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>location_name</code> یا <code>location_coordinate</code> متعین کرنے کی ضرورت نہیں</strong><br>آپ سرچ انجنز کے دستیاب مقامات کی فہرست ان کے <code>location_code</code> کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: <code>https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations</code><br>مثال:<br><code class=\"long-string\">2840</code>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<p><em>مقام کے GPS کوآرڈینیٹس</em><p><strong>اگر آپ <code>location_name</code>&nbsp;یا <code>location_code</code> متعین نہ کریں تو درکار فیلڈ</strong><p><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>location_name</code> یا <code>location_code</code> متعین کرنے کی ضرورت نہیں</strong><p><code>location_coordinate</code> پیرامیٹر <em>\"latitude,longitude,radius\"</em> فارمیٹ میں متعین کرنا چاہیے<p><em>\"latitude\"</em> اور <em>\"longitude\"</em> کے لیے اعشاریہ ہندسوں کی زیادہ سے زیادہ تعداد: 7<p><em>\"radius\"</em> کی کم از کم قدر: 199 (mm)<p><em>\"radius\"</em> کی زیادہ سے زیادہ قدر: 199999 (mm)<p>مثال:<p><code class=\"long-string\">53.476225,-2.243572,200</code></p>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>سرچ انجن زبان کا پورا نام</em><br>اگر آپ <code>language_code</code> متعین نہ کریں تو درکار فیلڈ؛<br>اگر آپ یہ فیلڈ استعمال کریں تو <code>language_code</code> متعین کرنے کی ضرورت نہیں؛<br>آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے <code>language_name</code> کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: <code>https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages</code><br>مثال: <code>English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>سرچ انجن زبان کا کوڈ</em><br>اگر آپ <code>language_name</code> متعین نہ کریں تو درکار فیلڈ؛<br>اگر آپ یہ فیلڈ استعمال کریں تو <code>language_name</code> متعین کرنے کی ضرورت نہیں؛<br>آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے <code>language_code</code> کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں: <code>https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages</code><br>مثال: <code>en</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>صارف کے متعین کردہ ٹاسک کا شناخت کنندہ</em><br>اختیاری فیلڈ<br><em>حروف کی حد 255 ہے</em><br>آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں<br>آپ جواب کے <code>data</code> آبجیکٹ میں متعین کردہ <code>tag</code> قدر دیکھیں گے"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "keyword": "albert einstein"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "keyword": "albert einstein"
    }
  ]
}
```

## Responses

### 200 — کامیاب آپریشن

Headers:
- `X-Request-Id` (string) — Felo سپورٹ سے رابطہ کرتے وقت شامل کرنے کے لیے درخواست کا شناخت کنندہ۔

**application/json**

Schema: object | null

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

### 400 — درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔

### 401 — درست Felo API کلید درکار ہے۔

### 402 — درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

### 403 — اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

### 429 — درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

### 502 — سروس درخواست مکمل نہیں کر سکی۔

### 503 — API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

### 504 — درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

### default — خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedResponseInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedResponseInfo`

```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_AiOptimizationGeminiLlmScraperLiveAdvancedTaskInfo"
              }
            ]
          },
          "description": "<em>ٹاسکس کی صف</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>POST صف میں موصول ہونے والا کی ورڈ<br></em><strong>کی ورڈ ڈی کوڈ شدہ %## کے ساتھ واپس کیا جاتا ہے (پلس سمبل '+' اسپیس کریکٹر میں ڈی کوڈ ہو جائے گا)</strong>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>POST صف میں مقام کا کوڈ</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>POST صف میں زبان کا کوڈ</em>"
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ماڈل کے ورژن کی نشاندہی کرتا ہے</em>"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>وہ تاریخ اور وقت جب نتیجہ موصول ہوا</em><br>UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”<br>مثال:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>مارک ڈاؤن فارمیٹ میں عنصر کا مواد</em><br>نتیجے کا مواد جو مارک ڈاؤن مارک اپ زبان میں فارمیٹ کیا گیا ہے"
    },
    "sources": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_SourceInfo"
          }
        ]
      },
      "description": "<em>ماخذوں کی صف</em><br>وہ ماخذ جنہیں ماڈل نے اپنے حتمی جواب میں درحقیقت نقل کیا یا ان پر انحصار کیا"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> نتائج کی کل تعداد</em>",
      "format": "int64"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>تلاش کے نتائج کی اقسام</em><br>ان تلاش کے نتائج کی اقسام (<code>items</code>) رکھتا ہے جو SERP میں ملتی ہیں۔<br>ممکنہ آئٹم اقسام:<br><code>gemini_text</code>، <code>gemini_table</code>، <code>gemini_images</code>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em><strong><code>items</code></strong> صف میں واپس کیے گئے نتائج کی تعداد</em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseGeminiLlmScraperElementItem"
          }
        ]
      },
      "description": "<em>Gemini نتائج کے عناصر</em>"
    }
  }
}
```

### Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationGeminiLlmScraperLiveAdvancedTaskInfo`

```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_AiOptimizationGeminiLlmScraperLiveAdvancedResultInfo"
              }
            ]
          },
          "description": "<em>نتائج کی صف</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseGeminiLlmScraperElementItem

`#/components/schemas/Response36Afe1097B20_BaseGeminiLlmScraperElementItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "عنصر کی قسم"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>SERP میں گروپ رینک</em><br>یکساں <code>type</code> اقدار والے عناصر کے گروپ کے اندر پوزیشن<br>مختلف <code>type</code> اقدار والے عناصر کی پوزیشنز <code>rank_group</code> سے خارج ہوتی ہیں"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>SERP میں مطلق درجہ</em><br>SERP کے تمام عناصر کے درمیان مطلق پوزیشن"
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>مارک ڈاؤن فارمیٹ میں عنصر کا مواد</em><br>نتیجے کا مواد جو مارک ڈاؤن مارک اپ زبان میں فارمیٹ کیا گیا ہے"
    }
  },
  "additionalProperties": false,
  "discriminator": {
    "propertyName": "type",
    "mapping": {
      "gemini_text": "#/components/schemas/Response36Afe1097B20_GeminiTextElementItem",
      "gemini_table": "#/components/schemas/Response36Afe1097B20_GeminiTableElementItem",
      "gemini_images": "#/components/schemas/Response36Afe1097B20_GeminiImagesElementItem"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "API کا موجودہ ورژن"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عمومی اسٹیٹس کوڈ\nرسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے"
    },
    "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\nرسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے"
    },
    "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 درخواست میں متعین کیے۔"
    }
  }
}
```

### Response36Afe1097B20_SourceInfo

`#/components/schemas/Response36Afe1097B20_SourceInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "عنصر کی قسم"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ماخذ کا عنوان</em>"
    },
    "snippet": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ماخذ کی تفصیل</em>"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>SERP میں ماخذ ڈومین</em>"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ماخذ URL</em>"
    },
    "thumbnail": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ماخذ کا تھمب نیل</em>"
    },
    "source_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ماخذ کا نام</em>"
    },
    "publication_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>وہ تاریخ اور وقت جب نتیجہ شائع ہوا</em><br>فارمیٹ میں: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”<br>مثال:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>مارک ڈاؤن فارمیٹ میں عنصر کا مواد</em><br>نتیجے کا مواد جو مارک ڈاؤن مارک اپ زبان میں فارمیٹ کیا گیا ہے"
    }
  }
}
```
