# OnPage 작업 설정

**API:** Data API

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

**Tags:** DataForSEO

`target` 크롤링을 시작하고 `tasks[0].id`에 작업 `id`를 반환합니다. **이 id가 이 계열의 다른 모든 도구에 필요한 핸들**이므로 보관하세요. `max_crawl_pages`는 크롤링 규모를 제한하고, `start_url`, `max_crawl_depth`, `priority_urls`, `crawl_delay`는 형태를 정하며, `store_raw_html`은 나중에 `post_dataforseo_on_page_raw_html`이 반환할 내용이 있는지를 결정합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 `tasks[0].result`, 처리 결과는 `tasks[0].status_code`에 있으며, 거부된 요청도 HTTP 200을 반환합니다. ⚠️ 이것은 일반적인 제출/조회 쌍이 아닙니다. 크롤링은 이후 여러 도구가 id로 조회하는 세션입니다. `get_dataforseo_on_page_summary`를 폴링해 `crawl_progress`가 `finished`가 될 때까지 기다리세요. example.com의 1페이지 크롤링은 1분이 채 걸리지 않았습니다.

### 가격 참고

- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.003.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## 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": {
          "target": {
            "type": "string",
            "description": "<em>대상 도메인</em><br><strong>필수 필드</strong><br>도메인 이름은 <code>https://</code>와 <code>www.</code> 없이 지정해야 합니다<br>페이지 URL을 지정하면 URL에 포함된 도메인에 대한 결과가 반환됩니다"
          },
          "max_crawl_pages": {
            "type": "integer",
            "description": "<em>크롤 페이지 한도</em><br><strong>필수 필드</strong><br>지정한 도메인에서 크롤할 페이지 수<br><strong>참고:</strong><br><code>max_crawl_pages</code>를 1로 설정하고 <code>start_url</code>을 지정하지 않거나 홈페이지를 지정하면 다음 사이트 전체 검사가 비활성화됩니다:<br><code>test_canonicalization</code>, <code>enable_www_redirect_check</code>, <code>test_hidden_server_signature</code>, <code>test_page_not_found</code>, <code>test_directory_browsing</code>, <code>test_https_redirect</code><br>그래도 활성화하려면 <code>force_sitewide_checks</code>를 <code>true</code>로 설정합니다<code>max_crawl_pages</code>를 1로 설정하고 홈페이지가 아닌 <code>start_url</code>을 지정하면 모든 사이트 전체 검사가 비활성화됩니다;<br>그래도 활성화하려면 <code>force_sitewide_checks</code>를 <code>true</code>로 설정합니다"
          },
          "start_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>크롤할 첫 번째 url </em><br>선택 필드<br><strong>참고:</strong> 절대 URL을 지정해야 합니다<br>단일 페이지를 크롤하려면 이 필드에 해당 URL을 지정하고 <code>max_crawl_pages</code> 매개변수를 <code>1</code>로 설정하세요<br>페이지별 데이터를 얻으려면 <a href=\"/v3/on_page/instant_pages/?bash\" target=\"_blank\" rel=\"noopener noreferrer\">live Instant Pages 엔드포인트</a>를 사용할 수도 있습니다"
          },
          "force_sitewide_checks": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>단일 페이지 크롤링 시 사이트 전체 검사 활성화</em><br>선택 필드<br>단일 페이지를 크롤링할 때 사이트 전체 검사 데이터를 얻으려면 <code>true</code>로 설정합니다;<br>기본값: <code>false</code>"
          },
          "priority_urls": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>대기열을 건너뛰고 크롤할 URL</em><br>선택 필드<br>이 배열에 지정한 URL은 크롤 대기열을 건너뛰고 가장 먼저 크롤됩니다;<br><strong>참고:</strong> 절대 URL을 지정해야 합니다;<br>최대 <strong>20개 URL</strong>을 지정할 수 있습니다;<br>배열의 모든 URL은 <code>target</code> 도메인에 속해야 합니다;<br><code>allow_subdomains</code> 매개변수가 <code>true</code>로 설정되지 않으면 하위 도메인은 무시됩니다예:<br>`\"priority_urls\": [<br>\"https://dataforseo.com/apis/serp-api\",<br>\"https://dataforseo.com/contact\"<br>]`"
          },
          "max_crawl_depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>크롤 깊이</em><br>선택 필드<br>크롤할 페이지의 링크 깊이입니다;<br>예를 들어 크롤 시작 페이지가 레벨 0이고, 해당 페이지에서 링크된 페이지가 레벨 1입니다."
          },
          "crawl_delay": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>요청 간 지연(ms)</em><br>선택 필드<br>크롤러가 서버에 요청하는 간격을 직접 지정합니다<br>기본값: <code>2000</code>"
          },
          "store_raw_html": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>크롤한 페이지의 HTML 저장</em><br>선택 필드<br><a href=\"/v3/on_page/raw_html/\" target=\"_blank\" rel=\"noopener noreferrer\">OnPage Raw HTML 엔드포인트</a>로 페이지의 HTML을 얻으려면 <code>true</code>로 설정합니다<br>기본값: <code>false</code>"
          },
          "enable_content_parsing": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>크롤한 페이지의 콘텐츠 파싱</em><br>선택 필드<br><a href=\"/v3/on_page/content_parsing/live/\" target=\"_blank\" rel=\"noopener noreferrer\">OnPage Content Parsing 엔드포인트</a>를 사용하려면 <code>true</code>로 설정합니다<br>기본값: <code>false</code>"
          },
          "support_cookies": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>크롤한 페이지에서 쿠키 지원</em><br>선택 필드<br>페이지를 크롤할 때 쿠키를 지원하려면 <code>true</code>로 설정합니다<br>기본값: <code>false</code>"
          },
          "accept_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>웹사이트 액세스용 언어 헤더</em><br>선택 필드<br>모든 로케일 형식(xx, xx-XX, xxx-XX 등)을 지원합니다<br><strong>참고:</strong> 이 매개변수를 지정하지 않으면 일부 웹사이트가 액세스를 거부할 수 있으며, 이 경우 응답 배열에서 <code>\"type\":\"broken</code>으로 페이지가 반환됩니다"
          },
          "custom_robots_txt": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>사용자 정의 robots.txt 설정</em><br>선택 필드<br>예: <code>Disallow: /directory1/</code>"
          },
          "robots_txt_merge_mode": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>robots.txt 설정 병합 또는 재정의</em><br>선택 필드<br>가능한 값: <code>merge</code>, <code>override</code>;<br>웹사이트 크롤링 제한과 기타 robots.txt 설정을 무시하려면 <code>override</code>로 설정합니다<br>기본값: <code>merge</code>;<br><strong>참고:</strong> <code>override</code>로 설정하면 <code>custom_robots_txt</code> 매개변수를 지정하세요"
          },
          "custom_user_agent": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>사용자 지정 User-Agent</em><br>선택 필드<br>웹사이트 크롤링에 사용할 사용자 지정 User-Agent<br>예: <code>Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36<br></code><br>기본값: <code>Mozilla/5.0 (compatible; RSiteAuditor)</code>"
          },
          "browser_preset": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>브라우저 화면 매개변수 프리셋</em><br>선택 필드<br>이 필드를 사용하면 <code>browser_screen_width</code>, <code>browser_screen_height</code>, <code>browser_screen_scale_factor</code>를 지정할 필요가 없습니다. 가능한 값:<br><code>desktop</code>, <code>mobile</code>, <code>tablet</code><code>desktop</code> 프리셋은 다음 값을 적용합니다:<code>browser_screen_width: 1920</code><br><code>browser_screen_height: 1080</code><br><code>browser_screen_scale_factor: 1</code><code>mobile</code> 프리셋은 다음 값을 적용합니다:<code>browser_screen_width: 390</code><br><code>browser_screen_height: 844</code><br><code>browser_screen_scale_factor: 3</code><code>tablet</code> 프리셋은 다음 값을 적용합니다:<code>browser_screen_width: 1024</code><br><code>browser_screen_height: 1366</code><br><code>browser_screen_scale_factor: 2</code><br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>enable_javascript</code> 또는 <code>enable_browser_rendering</code>을 <code>true</code>로 설정하세요"
          },
          "browser_screen_width": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>브라우저 화면 너비</em><br>선택 필드<br>특정 기기에 대한 감사를 수행하도록 사용자 지정 브라우저 화면 너비를 설정할 수 있습니다;<br>이 필드를 사용하면 <code>browser_preset</code>은 무시되므로 지정할 필요가 없습니다;<br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>enable_javascript</code> 또는 <code>enable_browser_rendering</code>을 <code>true</code>로 설정하세요 최솟값(픽셀): <code>240</code><br>최댓값(픽셀): <code>9999</code>",
            "format": "int64"
          },
          "browser_screen_height": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>브라우저 화면 높이</em><br>선택 필드<br>특정 기기에 대한 감사를 수행하도록 사용자 지정 브라우저 화면 높이를 설정할 수 있습니다;<br>이 필드를 사용하면 <code>browser_preset</code>은 무시되므로 지정할 필요가 없습니다;<br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>enable_javascript</code> 또는 <code>enable_browser_rendering</code>을 <code>true</code>로 설정하세요 최솟값(픽셀): <code>240</code><br>최댓값(픽셀): <code>9999</code>"
          },
          "browser_screen_scale_factor": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>브라우저 화면 배율</em><br>선택 필드<br>특정 기기에 대한 감사를 수행하도록 사용자 지정 브라우저 화면 해상도 비율을 설정할 수 있습니다;<br>이 필드를 사용하면 <code>browser_preset</code>은 무시되므로 지정할 필요가 없습니다;<br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>enable_javascript</code> 또는 <code>enable_browser_rendering</code>을 <code>true</code>로 설정하세요 최솟값: <code>0.5</code><br>최댓값: <code>3</code>"
          },
          "respect_sitemap": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>크롤 시 sitemap 준수</em><br>선택 필드<br>크롤할 때 기본 sitemap에 표시된 페이지 순서를 따르려면 <code>true</code>로 설정합니다;<br>기본값: <code>false</code><br><strong>참고:</strong> <code>true</code>로 설정하면 API 응답의 <code>click_depth</code> 값이 <code>0</code>이 됩니다;<br>요청의 <code>max_crawl_depth</code> 필드는 무시되며, <code>max_crawl_pages</code> 매개변수로 크롤할 페이지 수를 지정할 수 있습니다"
          },
          "custom_sitemap": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>사용자 정의 sitemap URL</em><br>선택 필드<br>대체 sitemap이 있는 페이지의 URL입니다<br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>respect_sitemap</code>이 <code>true</code>여야 합니다"
          },
          "crawl_sitemap_only": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>sitemap에 표시된 페이지만 크롤</em><br>선택 필드<br><code>true</code>로 설정하면 sitemap에 표시된 페이지만 크롤합니다<br>이 매개변수를 <code>true</code>로 설정하고 <code>custom_sitemap</code>을 지정하지 않으면 기본 sitemap을 크롤합니다<br>기본값: <code>false</code><br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>respect_sitemap</code>이 <code>true</code>여야 합니다"
          },
          "load_resources": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>리소스 로드</em><br>선택 필드<br>이미지, 스타일시트, 스크립트 및 깨진 리소스를 로드하려면 <code>true</code>로 설정합니다<br>기본값: <code>false</code><br><strong>참고:</strong> 이 매개변수를 사용하면 추가 비용이 발생합니다. 이 매개변수가 있는 작업의 비용은 <a href=\"https://dataforseo.com/help-center/cost-of-onpage-api-parameters\" target=\"_blank\" rel=\"noopener noreferrer\">도움말 문서</a>에서 자세히 확인하세요. 비용은 <a href=\"https://dataforseo.com/pricing/on-page/onpage-api\" target=\"_blank\" rel=\"noopener noreferrer\">가격 페이지</a>에서 계산할 수 있습니다"
          },
          "enable_www_redirect_check": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>도메인의 www 리디렉션 구현 여부 확인</em><br>선택 필드<br>요청한 도메인이 www에서 non-www로 또는 non-www에서 www로 리디렉션을 구현했는지 확인하려면 <code>true</code>로 설정합니다;<br>기본값: <code>false</code>"
          },
          "enable_javascript": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>페이지에서 javascript 로드</em><br>선택 필드<br>페이지에서 사용할 수 있는 스크립트를 로드하려면 <code>true</code>로 설정합니다<br>기본값: <code>false</code><br><strong>참고:</strong> 이 매개변수를 사용하면 추가 비용이 발생합니다. 이 매개변수가 있는 작업의 비용은 <a href=\"https://dataforseo.com/help-center/cost-of-onpage-api-parameters\" target=\"_blank\" rel=\"noopener noreferrer\">도움말 문서</a>에서 자세히 확인하세요. 비용은 <a href=\"https://dataforseo.com/pricing/on-page/onpage-api\" target=\"_blank\" rel=\"noopener noreferrer\">가격 페이지</a>에서 계산할 수 있습니다"
          },
          "enable_xhr": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>페이지에서 XMLHttpRequest 활성화</em><br>선택 필드<br>크롤러가 XMLHttpRequest 객체로 웹 서버에 데이터를 요청하게 하려면 <code>true</code>로 설정합니다<br>기본값: <code>false</code>;이 필드를 사용하면 <code>enable_javascript</code>를 <code>true</code>로 설정해야 합니다;"
          },
          "enable_browser_rendering": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>Core Web Vitals 측정을 위한 브라우저 렌더링 에뮬레이션</em><br>선택 필드<br>이 매개변수를 사용하면 웹 페이지를 로드할 때 브라우저를 에뮬레이션할 수 있습니다;<br><code>enable_browser_rendering</code>은 페이지의 스타일, 이미지, 글꼴, 애니메이션, 동영상 및 기타 리소스를 로드합니다;<br>기본값: <code>false</code><br>응답에서 Core Web Vitals(FID, CLS, LCP) 지표를 얻으려면 <code>true</code>로 설정합니다;<br><strong>이 필드를 사용하면 <code>enable_javascript</code>와 <code>load_resources</code> 매개변수를 <code>true</code>로 설정해야 합니다</strong><br><strong>참고:</strong> 이 매개변수를 사용하면 추가 비용이 발생합니다. 이 매개변수가 있는 작업의 비용은 <a href=\"https://dataforseo.com/help-center/cost-of-onpage-api-parameters\" target=\"_blank\" rel=\"noopener noreferrer\">도움말 문서</a>에서 자세히 확인하세요. 비용은 <a href=\"https://dataforseo.com/pricing/on-page/onpage-api\" target=\"_blank\" rel=\"noopener noreferrer\">가격 페이지</a>에서 계산할 수 있습니다"
          },
          "disable_cookie_popup": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>쿠키 팝업 비활성화</em><br>선택 필드<br>사용자에게 쿠키 동의를 요청하는 팝업을 비활성화하려면 <code>true</code>로 설정합니다;<br>기본값:<br><code>false</code>"
          },
          "custom_js": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>사용자 정의 javascript</em><br>선택 필드<br><strong>참고:</strong> 여기에 입력하는 스크립트의 실행 시간은 최대 700ms여야 합니다. 예를 들어 다음 JS 스니펫을 사용해 웹사이트에 Google Tag Manager가 <code>scr</code> 속성으로 포함되어 있는지 확인할 수 있습니다:<br><code>let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i &lt; document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute(\"src\");rn if (src != undefined) {rn if (src.indexOf(\"analytics.js\") &gt;= 0)rn      meta.haveGoogleAnalytics = true;rntif (src.indexOf(\"gtm.js\") &gt;= 0)rn      meta.haveTagManager = true;rn  }rn}rnmeta;</code>반환되는 값은 이 필드에 지정한 내용에 따라 달라집니다. 예를 들어 다음 스크립트를 지정하면:<br>`meta = {}; meta.url = document.URL; meta.test = 'test'; meta;`<br>응답으로 다음 데이터가 반환됩니다:<br>`\"custom_js_response\": {<br>\"url\": \"https://dataforseo.com/\",<br>\"test\": \"test\"<br>}`<br><strong>참고:</strong> 입력하는 스크립트의 길이는 2000자를 넘을 수 없습니다"
          },
          "validate_micromarkup": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>마이크로데이터 검증 활성화</em><br>선택 필드<br><a href=\"/v3/on_page/microdata/\" target=\"_blank\" rel=\"noopener noreferrer\">OnPage API Microdata 엔드포인트</a>를 사용하려면 <code>true</code>로 설정합니다<br>기본값: <code>false</code>"
          },
          "allow_subdomains": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>하위 도메인의 페이지 포함</em><br>선택 필드<br>대상 웹사이트의 모든 하위 도메인을 크롤링하려면 <code>true</code>로 설정하세요<br>기본값: <code>false</code>"
          },
          "allowed_subdomains": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>크롤링할 하위 도메인</em><br>선택 필드<br>크롤링할 하위 도메인을 지정하세요<br>예: <code>[\"blog.site.com\", \"my.site.com\", \"shop.site.com\"]</code><br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>allow_subdomains</code> 매개변수를 <code>false</code>로 설정해야 합니다;<br>그렇지 않으면 <code>allowed_subdomains</code> 필드의 내용이 무시되고 모든 하위 도메인에 대한 결과가 반환됩니다"
          },
          "disallowed_subdomains": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>크롤하지 않을 하위 도메인</em><br>선택 필드<br>크롤하지 않을 하위 도메인을 지정합니다<br>예: <code>[\"status.site.com\", \"docs.site.com\"]</code><br><strong>참고:</strong> 이 매개변수를 사용하려면 <code>allow_subdomains</code> 매개변수를 <code>true</code>로 설정해야 합니다"
          },
          "check_spell": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>맞춤법 검사</em><br>선택 필드<br><a href=\"http://hunspell.github.io/\" target=\"_blank\" rel=\"noopener noreferrer\">Hunspell</a> 라이브러리를 사용하여 웹사이트의 맞춤법을 검사하려면 <code>true</code>로 설정하세요<br>기본값: <code>false</code>"
          },
          "check_spell_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>맞춤법 검사 언어</em><br>선택 필드<br>지원 언어: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'<br><strong>참고:</strong> 언어를 지정하지 않으면 페이지 콘텐츠에 따라 자동으로 설정됩니다"
          },
          "check_spell_exceptions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>맞춤법 검사에서 제외할 단어</em><br>선택 필드<br>맞춤법 검사에서 제외할 단어를 지정하세요<br>최대 단어 길이: 100자<br>최대 단어 수: 1000<br>예: <code>\"SERP\", \"minifiers\", \"JavaScript\"</code>"
          },
          "calculate_keyword_density": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>대상 도메인의 키워드 밀도 계산</em><br>선택 필드<br>웹사이트 페이지의 키워드 밀도를 계산하려면 <code>true</code>로 설정하세요<br>기본값: <code>false</code><br><strong>참고:</strong> 이 매개변수를 사용하면 추가 요금이 부과됩니다. 이 매개변수가 있는 작업의 비용은 <a href=\"https://dataforseo.com/help-center/cost-of-onpage-api-parameters\" target=\"_blank\" rel=\"noopener noreferrer\">도움말 문서</a>에서 자세히 알아보세요<br>크롤링이 완료되면 <a href=\"/v3/on_page/keyword_density?bash\" target=\"_blank\" rel=\"noopener noreferrer\">Keyword Density 엔드포인트</a>에서 키워드 밀도 값을 얻을 수 있습니다"
          },
          "checks_threshold": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {
              "type": [
                "integer",
                "null"
              ],
              "format": "int64"
            },
            "description": "<em>검사에 사용할 사용자 지정 임계값</em><br>선택 필드<br>OnPage API 응답의 <code>checks</code> 객체에 포함된 매개변수에 대해 사용자 지정 임계값을 지정할 수 있습니다;<br><strong>참고:</strong> 정수 임계값만 수정할 수 있습니다;<br>예를 들어 <code>high_loading_time</code> 및 <code>large_page_size</code> 매개변수는 기본적으로 각각 3초와 1MB로 설정되어 있습니다;<br>이 임계값을 1초와 1000KB로 변경하려면 다음 스니펫을 사용하세요:<br>`\"checks_threshold\": {<br>\"high_loading_time\": 1,<br>\"large_page_size\": 1000<br>}`<br>기본값과 함께 사용자 지정할 수 있는 매개변수:<br>`\"title_too_short\", default value: 30, type: \"int\"<br>\"title_too_long\", default value: 65, type: \"int\"<br>\"small_page_size\", default value: 1024, type: \"int\"<br>\"large_page_size\", default value: 1048576 (1024 * 1024), type: \"int\"<br>\"low_character_count\", default value: 1024, type: \"int\"<br>\"high_character_count\", default value: 256000 (250 * 1024), type: \"int\"<br>\"low_content_rate\", default value: 0.1, type: \"float\"<br>\"high_content_rate\", default value: 0.9, type: \"float\"<br>\"high_loading_time\", default value: 3000, type: \"int\"<br>\"high_waiting_time\", default value: 1500, type: \"int\"<br>\"low_readability_rate\", default value: 15.0, type: \"float\"<br>\"irrelevant_description\", default value: 0.2, type: \"float\"<br>\"irrelevant_title\", default value: 0.3, type: \"float\"<br>\"irrelevant_meta_keywords\", default value: 0.6, type: \"float\"`"
          },
          "disable_sitewide_checks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>특정 사이트 전체 검사 실행 방지</em><br>선택 필드<br><code>target</code> 웹사이트에서 실행하지 않을 <code>checks</code>를 지정합니다:<br><code>\"test_page_not_found\"</code><br><code>\"test_canonicalization\"</code><br><code>\"test_https_redirect\"</code><br><code>\"test_directory_browsing\"</code>예:<br><code>\"disable_sitewide_checks\": [\"test_directory_browsing\", \"test_page_not_found\"]</code>자세한 내용은 <a href=\"https://dataforseo.com/help-center/how-to-disable-sitewide-checks-in-onpage-api\" target=\"_blank\" rel=\"noopener noreferrer\">도움말 센터</a>에서 확인하세요"
          },
          "disable_page_checks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>특정 페이지 검사 실행 방지</em><br>선택 필드<br>특정 <code>checks</code>를 지정해 실행을 막고 <code>onpage_score</code>에 영향을 주지 않게 합니다예:<br><code>\"disable_page_checks\": [\"is_5xx_code\", \"is_4xx_code\"]</code>"
          },
          "switch_pool": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>프록시 풀 전환</em><br>선택 필드<br><code>true</code>이면 추가 프록시 풀을 사용하여 요청한 데이터를 가져옵니다;<br>이 매개변수는 다수의 작업이 동시에 설정되어 간헐적으로 <code>rate-limit</code> 및/또는 <code>site_unreachable</code> 오류가 발생하는 경우 사용할 수 있습니다"
          },
          "return_despite_timeout": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>시간 초과 오류에도 페이지 데이터 반환</em><br>선택 필드<br><code>true</code>이면 120초 내에 로드하지 못하고 시간 초과 오류를 반환한 페이지에 대해서도 데이터를 제공합니다;<br>기본값: <code>false</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>사용자 정의 작업 식별자</em><br>선택 필드<br><em>최대 255자</em><br>이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다<br><code>tag</code>에 지정한 값은 응답의 <code>data</code> 객체에서 확인할 수 있습니다"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>완료된 작업의 알림 URL</em><br>선택 필드<br>작업이 완료되면 지정한 URL로 GET 요청을 보내 알립니다<br>‘$id’ 문자열을 <code>$id</code> 변수로, ‘$tag’를 urlencoded <code>$tag</code> 변수로 사용할 수 있습니다. 요청을 보내기 전에 필요한 값을 설정합니다.<br>예:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>참고:</strong> <code>pingback_url</code>의 특수 문자는 urlencoded됩니다;<br>즉, <code>#</code> 문자는 <code>%23</code>으로 인코딩됩니다<p>자세한 내용은 <a href=\"https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api\" target=\"_blank\" rel=\"noopener noreferrer\">Help Center</a>를 참고하세요"
          }
        },
        "example": [
          {
            "target": "dataforseo.com",
            "max_crawl_pages": 10,
            "load_resources": true,
            "enable_javascript": true,
            "custom_js": "meta = {}; meta.url = document.URL; meta;",
            "tag": "some_string_123",
            "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "dataforseo.com",
      "max_crawl_pages": 10,
      "load_resources": true,
      "enable_javascript": true,
      "custom_js": "meta = {}; meta.url = document.URL; meta;",
      "tag": "some_string_123",
      "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
    }
  ]
}
```

## Responses

### 200 — 작업 성공

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: object | null

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

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

`#/components/schemas/Response36Afe1097B20_OnPageTaskPostResponseInfo`

```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_OnPageTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>작업 배열</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_OnPageTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_OnPageTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>결과 배열</em><br>이 경우 값은 <code>null</code>입니다"
        }
      }
    }
  ]
}
```