# SERP API صفحہ اسکرین شاٹ

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/screenshot`

**Tags:** DataForSEO

Google پر کسی سرچ رزلٹ صفحے کا رینڈر شدہ اسکرین شاٹ واپس کرتا ہے۔ `keyword`، `type`، `se_domain`، `location_code`، `language_code`، `check_url`، `datetime`، `spell`، `refinement_chips`، `item_types`، `items_count` اور `items` واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا `tasks[0].result` میں، نتیجہ `tasks[0].status_code` میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔

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

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

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

## Related links

- [UUID](<https://en.wikipedia.org/wiki/Universally_unique_identifier>)

## 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": {
          "task_id": {
            "type": "string",
            "description": "<em>ٹاسک شناخت کنندہ</em><br><strong>درکار فیلڈ</strong><br>متعلقہ ٹاسک کا منفرد شناخت کنندہ UUID فارمیٹ میں<br>آپ اسے <strong>7 دن</strong> کے اندر کسی بھی وقت ٹاسک کے نتائج کی درخواست کے لیے استعمال کر سکیں گے"
          },
          "browser_preset": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>براؤزر ریزولوشن پریسیٹ</em><br>اختیاری فیلڈ<br>کسی مخصوص ڈیوائس قسم سے وابستہ براؤزر پریسیٹ<br>درج ذیل اقدار لے سکتا ہے: <code>desktop</code>، <code>tablet</code>، <code>mobile</code> <br><strong>نوٹ:</strong> ڈیفالٹ طور پر براؤزر پریسیٹ POST درخواست میں متعین کردہ ڈیوائس قسم سے مطابقت رکھتا ہے"
          },
          "browser_screen_width": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>براؤزر ریزولوشن کی چوڑائی</em><br>اختیاری فیلڈ<br>درج ذیل حد میں متعین کیا جا سکتا ہے: <code>240-9999</code><br><code>desktop</code> کے لیے ڈیفالٹ قدر: 1920<br><code>mobile</code> کے لیے ڈیفالٹ قدر: 390<br><code>table</code> کے لیے ڈیفالٹ قدر: 1024",
            "format": "int64"
          },
          "browser_screen_height": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>براؤزر ریزولوشن کی اونچائی</em><br>اختیاری فیلڈ<br>درج ذیل حد میں متعین کیا جا سکتا ہے: <code>240-9999</code><br><code>desktop</code> کے لیے ڈیفالٹ قدر: 1080<br><code>mobile</code> کے لیے ڈیفالٹ قدر: 844<br><code>table</code> کے لیے ڈیفالٹ قدر: 1366"
          },
          "browser_screen_scale_factor": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>براؤزر اسکیل فیکٹر</em><br>اختیاری فیلڈ<br>درج ذیل حد میں متعین کیا جا سکتا ہے: <code>0.5-3</code><br><code>desktop</code> کے لیے ڈیفالٹ قدر: 1<br><code>mobile</code> کے لیے ڈیفالٹ قدر: 3<br><code>table</code> کے لیے ڈیفالٹ قدر: 2"
          },
          "page": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>SERP صفحات کی تعداد</em><br>اختیاری فیلڈ<br>اگر متعلقہ Task POST درخواست میں <code>depth</code> 10 نتائج (یا 1 SERP صفحہ) سے زیادہ ہو تو اسکرین شاٹ کے لیے SERP صفحات کی تعداد متعین کریں؛<br>ڈیفالٹ قدر: <code>1</code>"
          }
        },
        "example": [
          {
            "task_id": "06211235-0696-0139-1000-36727fbd3c90",
            "browser_screen_scale_factor": 0.5
          }
        ]
      }
    ]
  },
  "example": [
    {
      "task_id": "06211235-0696-0139-1000-36727fbd3c90",
      "browser_screen_scale_factor": 0.5
    }
  ]
}
```

## Responses

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

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

**application/json**

Schema: object | null

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

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

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

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

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

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

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

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

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

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

**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": "عمومی اسٹیٹس کوڈ\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_ScreenshotItem

`#/components/schemas/Response36Afe1097B20_ScreenshotItem`

```json
{
  "type": "object",
  "properties": {
    "image": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>درخواست کردہ صفحے کا اسکرین شاٹ</em><br>DataForSEO اسٹوریج پر صفحے کے اسکرین شاٹ کا URL<br><strong>نوٹ: DataForSEO اسٹوریج پر محفوظ صفحے کا اسکرین شاٹ درخواست کرنے کے بعد صرف ایک دن تک قابل رسائی رہتا ہے</strong>"
    }
  }
}
```

### Response36Afe1097B20_SerpScreenshotResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpScreenshotResponseInfo`

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

### Response36Afe1097B20_SerpScreenshotResultInfo

`#/components/schemas/Response36Afe1097B20_SerpScreenshotResultInfo`

```json
{
  "type": "object",
  "properties": {
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>نتائج کی صف میں آئٹمز کی تعداد</em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ScreenshotItem"
          }
        ]
      },
      "description": "<em>آئٹمز کی صف</em>"
    }
  }
}
```

### Response36Afe1097B20_SerpScreenshotTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpScreenshotTaskInfo`

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