# OnPage API কাঁচা HTML

**API:** Data API

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

**Tags:** DataForSEO

একটি ক্রল করা `url`-এর সংরক্ষিত HTML। এটি সম্পন্ন হওয়া ক্রল থেকে পড়ে, তাই `post_dataforseo_on_page_submit` থেকে পাওয়া `id` দরকার এবং `crawl_progress`-এর সাথে `crawl_status` ফেরত দেয় যাতে থাকে `max_crawl_pages`, `pages_in_queue` ও `pages_crawled` — ছোট ফলাফলে ভরসা করার আগে এগুলো যাচাই করুন, কারণ চলমান ক্রলের রিপোর্ট করার জিনিস কম থাকে। ⚠️ কেবল তখনই পাওয়া যায় যখন ক্রল `store_raw_html` সেট করে সাবমিট করা হয়েছে — নইলে ফেরত দেওয়ার কিছু নেই, এবং পরে ক্রল সংশোধন করা যায় না। সোর্সের বদলে পার্স করা কনটেন্টের জন্য `post_dataforseo_on_page_content_parsing` ব্যবহার করুন। 💰 আপস্ট্রিম ফ্রি: সম্পন্ন হওয়া ক্রল কোয়েরি করতে কোনো খরচ নেই, খরচ শুধু ক্রলের নিজেরই।

### মূল্য রেফারেন্স

- মিটারিং: সফল রিকোয়েস্টের নির্দিষ্ট খরচের ভিত্তিতে
- রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.012
- রেফারেন্স গ্রাহক মাল্টিপ্লায়ার: 1.0। নিষ্পত্তিকৃত গ্রাহক অঙ্কে এটি আবার প্রয়োগ করবেন না।

এটি কেবল রেফারেন্স মেটাডেটা; অ্যাকাউন্টের কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo-এর বিলিং রেকর্ড অনুযায়ী হয়।

## Related links

- [Task POST](<https://docs.dataforseo.com/v3/on_page/task_post/>)
- [Instant Pages endpoint](<https://docs.dataforseo.com/v3/on_page/instant_pages/>)

## 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-এর response-এ পেতে পারেন<br>উদাহরণ:<br>\"07131248-1535-0216-1000-17384017ad04\""
          },
          "url": {
            "type": "string",
            "description": "<em>পেজ url</em><br><strong>আবশ্যক ফিল্ড</strong><br>HTML অনুরোধ করার পেজের পরম URL<br><strong>নোট:</strong> Instant Pages endpoint ব্যবহার করে টাস্ক সেট করা হলে এই ফিল্ড ঐচ্ছিক"
          }
        },
        "example": [
          {
            "id": "07281559-0695-0216-0000-c269be8b7592",
            "url": "https://dataforseo.com/apis"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "id": "07281559-0695-0216-0000-c269be8b7592",
      "url": "https://dataforseo.com/apis"
    }
  ]
}
```

## Responses

### 200 — সফল অপারেশন

Headers:
- `X-Request-Id` (string) — Felo সাপোর্টে যোগাযোগের সময় অন্তর্ভুক্ত করার জন্য রিকোয়েস্ট আইডেন্টিফায়ার।

**application/json**

Schema: object | null

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

### 400 — রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।

### 401 — একটি বৈধ Felo API key আবশ্যক।

### 402 — বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।

### 403 — অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।

### 429 — রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।

### 502 — পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।

### 503 — API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।

### 504 — রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।

### default — ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।

**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সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন"
    },
    "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সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন"
    },
    "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_OnPageRawHtmlItem

`#/components/schemas/Response36Afe1097B20_OnPageRawHtmlItem`

```json
{
  "type": "object",
  "properties": {
    "html": {
      "type": [
        "string",
        "null"
      ],
      "description": "<i>HTML_</i><i>পেজ</i>"
    }
  }
}
```

### Response36Afe1097B20_OnPageRawHtmlResponseInfo

`#/components/schemas/Response36Afe1097B20_OnPageRawHtmlResponseInfo`

```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_OnPageRawHtmlTaskInfo"
              }
            ]
          },
          "description": "<em>টাস্কের অ্যারে</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_OnPageRawHtmlResultInfo

`#/components/schemas/Response36Afe1097B20_OnPageRawHtmlResultInfo`

```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>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>ফলাফল অ্যারেতে আইটেমের সংখ্যা</em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_OnPageRawHtmlItem"
        }
      ],
      "description": "<em>items অবজেক্ট</em>"
    }
  }
}
```

### Response36Afe1097B20_OnPageRawHtmlTaskInfo

`#/components/schemas/Response36Afe1097B20_OnPageRawHtmlTaskInfo`

```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_OnPageRawHtmlResultInfo"
              }
            ]
          },
          "description": "<em>ফলাফলের অ্যারে</em>"
        }
      }
    }
  ]
}
```
