# ناقابلِ کرال ریسورسز

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/on_page/uncrawlable_resources`

**Tags:** DataForSEO

وہ ریسورسز جو کرال حاصل نہ کر سکا، اور کیوں۔ `total_items_count`، `items_count` اور `items` واپس کرتا ہے۔ مکمل شدہ کرال پڑھتا ہے، اس لیے اسے `post_dataforseo_on_page_submit` سے `id` درکار ہوتی ہے اور `crawl_progress` کے ساتھ `crawl_status` واپس کرتا ہے جس میں `max_crawl_pages`، `pages_in_queue` اور `pages_crawled` شامل ہیں - کسی چھوٹے نتیجے پر بھروسہ کرنے سے پہلے یہ دیکھیں، کیونکہ ابھی جاری کرال کے پاس بتانے کو کم ہوتا ہے۔ یہ وہ ٹوٹے حوالہ جات ہیں جو سائٹ مالک سب سے پہلے چاہے گا؛ جو لوڈ ہو گئے وہ `post_dataforseo_on_page_resources` میں ہیں۔ 💰 اپ اسٹریم مفت: مکمل شدہ کرال سے استفسار کرنے کی کوئی لاگت نہیں، لاگت صرف خود کرال کی ہے۔

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

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

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

## Related links

- [Task POST](<https://docs.dataforseo.com/v3/on_page/task_post/>)
- [اس لنک](<https://docs.dataforseo.com/v3/on_page/filters_and_thresholds/?bash>)
- [یہاں](<https://docs.dataforseo.com/v3/appendix/errors>)

## 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": {
          "id": {
            "type": "string",
            "description": "<em>ٹاسک کی ID</em><br><strong>درکار فیلڈ</strong><br>آپ یہ ID Task POST endpoint کے جواب میں حاصل کر سکتے ہیں<br>مثال:<br>\"07131248-1535-0216-1000-17384017ad04\""
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>واپس کیے جانے والے ناقابلِ کرال ریسورسز کی زیادہ سے زیادہ تعداد</em><br>اختیاری فیلڈ<br>ڈیفالٹ قدر: <code>100</code><br>زیادہ سے زیادہ قدر: <code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>واپس کیے گئے ناقابلِ کرال ریسورسز کی نتائج صف میں آفسیٹ</em><br>اختیاری فیلڈ<br>ڈیفالٹ قدر: <code>0</code><br> زیادہ سے زیادہ قدر: <code>2000000</code><br>اگر آپ قدر <code>10</code> متعین کریں تو نتائج کی صف میں پہلے دس غلط ریسورسز چھوڑ دیے جائیں گے اور ڈیٹا اگلے غلط ریسورسز کے لیے فراہم کیا جائے گا"
          },
          "order_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>نتائج کی ترتیب کے قواعد</em><br>اختیاری فیلڈ<br>آپ نتائج کی ترتیب کے لیے <code>filters</code> صف کی طرح وہی اقدار استعمال کر سکتے ہیں<br>ممکنہ ترتیب کی اقسام:<br><code>asc</code> - نتائج صعودی ترتیب میں ترتیب دیے جائیں گے<br><code>desc</code> - نتائج نزولی ترتیب میں ترتیب دیے جائیں گے<br>ترتیب کی قسم مقرر کرنے کے لیے کوما استعمال کریں<br>مثال:<br><code>[\"meta.content_type,desc\"]</code><br><strong>نوٹ کریں کہ ایک ہی درخواست میں زیادہ سے زیادہ تین ترتیب کے قواعد مقرر کیے جا سکتے ہیں</strong><br>کئی ترتیب کے قواعد کو الگ کرنے کے لیے کوما استعمال کریں<br>مثال:<br><code>[\"meta.content_type,asc\",\"fetch_time,desc\"]</code>"
          },
          "filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>نتائج کی فلٹرنگ پیرامیٹرز کی صف</em><br>اختیاری فیلڈ<br><strong>آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)</strong><br>شرائط کے درمیان آپ کو منطقی آپریٹر <code>and</code>، <code>or</code> سیٹ کرنا چاہیے<br>درج ذیل آپریٹرز معاون ہیں:<br><code>regex</code>، <code>not_regex</code>، <code>&lt;</code>، <code>&lt;=</code>، <code>&gt;</code>، <code>&gt;=</code>، <code>=</code>، <code>&lt;&gt;</code>، <code>in</code>، <code>not_in</code>، <code>like</code>، <code>not_like</code><br>آپ <code>%</code> آپریٹر <code>like</code> اور <code>not_like</code> کے ساتھ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیے استعمال کر سکتے ہیں<br>مثال:<br><code> [[\"meta.content_type\",\"=\",\"image/jpeg\"],<br>\"and\",<br>[\"url\",\"not_like\",\"%/help-center/%\"]]</code><p>ممکنہ فلٹرز کی مکمل فہرست اس لنک پر دستیاب ہے۔"
          }
        },
        "example": [
          {
            "id": "07281559-0695-0216-0000-c269be8b7592",
            "filters": [
              [
                "meta.content_type",
                "=",
                "image/jpeg"
              ],
              "and",
              [
                "url",
                "like",
                "%go%"
              ]
            ],
            "limit": 10
          }
        ]
      }
    ]
  },
  "example": [
    {
      "id": "07281559-0695-0216-0000-c269be8b7592",
      "filters": [
        [
          "meta.content_type",
          "=",
          "image/jpeg"
        ],
        "and",
        [
          "url",
          "like",
          "%go%"
        ]
      ],
      "limit": 10
    }
  ]
}
```

## Responses

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

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

**application/json**

Schema: object | null

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

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

`#/components/schemas/Response36Afe1097B20_CrawlStatusInfo`

```json
{
  "type": "object",
  "properties": {
    "max_crawl_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "کرال کی جانے والی صفحات کی زیادہ سے زیادہ تعداد\n ٹاسک سیٹ کرتے وقت آپ کے متعین کردہ max_crawl_pages کی حد بتاتا ہے",
      "format": "int64"
    },
    "pages_in_queue": {
      "type": [
        "integer",
        "null"
      ],
      "description": "اس وقت کرالنگ قطار میں موجود صفحات کی تعداد",
      "format": "int64"
    },
    "pages_crawled": {
      "type": [
        "integer",
        "null"
      ],
      "description": "کرال شدہ صفحات کی تعداد",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_OnPageUncrawlableResourcesItem

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesItem`

```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>کرال نہ ہو سکنے والے ریسورس کا URL</em>"
    },
    "reason": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ریسورس کرال نہ ہو سکنے کی وجہ</em><br>درج ذیل اقدار اختیار کر سکتا ہے: <code>content_type_inconsistency</code>"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<i>عمومی اسٹیٹس کوڈ</i><br>جوابی کوڈز کی مکمل فہرست آپ یہاں دیکھ سکتے ہیں<br><strong>نوٹ:</strong> ہم متعلقہ استثنائی یا خرابی کی حالتوں کو سنبھالنے کے لیے ضروری نظام ڈیزائن کرنے کی سختی سے سفارش کرتے ہیں"
    },
    "fetch_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>وہ تاریخ اور وقت جب ریسورس حاصل کیا گیا</em><br>UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”<br>مثال:<br><code>2026-03-09 18:20:32 +00:00</code>"
    },
    "meta": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_UncrawlableResourcesMeta"
        }
      ],
      "description": "<em>کرال نہ ہو سکنے والے ریسورس کا میٹا ڈیٹا</em>"
    }
  }
}
```

### Response36Afe1097B20_OnPageUncrawlableResourcesResponseInfo

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesResponseInfo`

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

### Response36Afe1097B20_OnPageUncrawlableResourcesResultInfo

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesResultInfo`

```json
{
  "type": "object",
  "properties": {
    "crawl_progress": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>کرالنگ سیشن کی حیثیت</em><br>ممکنہ اقدار: <code>in_progress</code>, <code>finished</code>"
    },
    "crawl_status": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_CrawlStatusInfo"
        }
      ],
      "description": "<em>کرالنگ سیشن کی تفصیلات</em>"
    },
    "current_offset": {
      "type": [
        "integer",
        "null"
      ]
    },
    "total_items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>ملنے والے کرال نہ ہو سکنے والے ریسورسز کی کل تعداد</em><br> ہدف ڈومین کی کرالنگ کے دوران ملنے والے کرال نہ ہو سکنے والے ریسورسز کی کل تعداد",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em><code>items</code> صف میں کرال نہ ہو سکنے والے ریسورسز کی تعداد</em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesItem"
          }
        ]
      },
      "description": "<em>کرال نہ ہو سکنے والے ریسورسز کی صف</em>"
    }
  }
}
```

### Response36Afe1097B20_OnPageUncrawlableResourcesTaskInfo

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesTaskInfo`

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

### Response36Afe1097B20_UncrawlableResourcesMeta

`#/components/schemas/Response36Afe1097B20_UncrawlableResourcesMeta`

```json
{
  "type": "object",
  "properties": {
    "content_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ریسورس کی اصل کنٹینٹ ٹائپ</em>"
    },
    "expected_content_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>ریسورس کے متوقع کنٹینٹ ٹائپس</em><br>ان کنٹینٹ ٹائپس کی فہرست جن کی کرالر نے صفحے پر ریسورس کے حوالے کی بنیاد پر توقع کی تھی"
    }
  }
}
```
