설명서

URL 1개 제출


HTTP 요청을 사용하여 URL을 제출하려면(검색 엔진에서 제공한 URL로 대체) 다음 URL로 요청을 보내주세요.

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • url-changed는 추가, 업데이트 또는 삭제된 웹 사이트의 URL입니다. URL은 이스케이프 처리하고 인코딩해야 하며, URL이 URI의 RFC-3986 표준을 따라야 합니다.
  • Your-key에는 최소 8자에서 최대 128자의 16진수 문자를 포함해야 합니다. 키는 소문자(a-z), 대문자(A-Z), 숫자(0-9) 및 대시(-) 문자만 포함할 수 있습니다.

예를 들어 https://www.example.com/product.html이 업데이트되었다는것을 ​​검색 엔진에 알리고 이 키를 사용하려는 경우 URL은 다음과 같습니다.

                https://<searchengine>/indexnow?url=https://www.example.com/product.html&key=
            

브라우저, wget, curl 또는 선택한 다른 메커니즘을 사용하여 HTTP를 요청할 수 있습니다. 요청이 성공하면 HTTP 200 응답 코드가 반환됩니다. 다른 응답을 받으면 너무 자주 제출하지 않았는지, 키와 URL이 유효한지 확인하고 요청을 다시 제출하세요. HTTP 200 응답 코드는 검색 엔진이 귀하의 URL을 수신했음을 나타냅니다.

URL 집합 제출


HTTP 요청을 사용하여 URL 집합을 제출하려면 검색 엔진에서 제공한 URL로 POST JSON 요청을 실행하세요. 검색 엔진의 호스트 이름으로 을 대체하세요.

                POST /indexnow HTTP/1.1
                Content-Type: application/json; charset=utf-8
                Host: <searchengine>
                {
                  "host": "www.example.com",
                  "key": "",
                  "urlList": [
                      "https://www.example.com/url1",
                      "https://www.example.com/folder/url2",
                      "https://www.example.com/url3"
                      ]
                }
            

필요한 경우 http 및 https URL을 혼합하여 게시물당 최대 10,000개까지 URL을 제출할 수 있습니다.

wget, curl 또는 선택한 다른 메커니즘을 사용하여 HTTP를 요청할 수 있습니다. 요청이 성공하면 HTTP 200 응답 코드가 반환됩니다. 다른 응답을 받으면 요청을 확인하고 모든 것이 정상으로 보이면 요청을 다시 제출해야 합니다. HTTP 200 응답 코드는 검색 엔진이 URL 집합을 수신했다는 것을 나타냅니다.

권장되는 방법은 콘텐츠가 어느 정도까지 추가, 업데이트 또는 삭제되는 즉시 URL 제출을 자동화하는 것입니다. 자주 묻는 질문에서 사용자 생성 콘텐츠에 대한 모범 사례를 참조하세요.

키를 통한 소유권 확인


URL을 제출하려면 호스트 내에서 하나 이상의 텍스트 파일을 호스팅하여 URL이 제출되는 호스트의 소유권을 "증명"해야 합니다. URL을 검색 엔진에 제출하면 검색 엔진은 키 파일을 크롤링하여 소유권을 확인하고 키를 변경할 때까지 키를 사용합니다. 귀하와 검색 엔진만 키와 파일 키 위치를 알고 있어야 합니다.

소유권을 확인하는 방법은 두 가지가 있습니다.

방법 1
호스트의 루트 디렉터리에서 텍스트 키 파일을 호스팅합니다.

웹 사이트의 루트 디렉터리에 있는 파일의 키가 나열된 UTF-8로 인코딩된 텍스트 키 파일 {your-key}.txt를 호스팅해야 합니다.

예를 들어, 이전 예의 경우 https://www.example.com/ .txt에서 UTF-8 키 파일을 호스팅해야 하며 이 파일에는 키가 포함되어야 합니다.

방법 2
호스트 내에서 텍스트 파일을 호스팅합니다.

동일한 호스트 내의 다른 위치에 한 개부터 여러 개의 UTF-8로 인코딩된 텍스트 키 파일을 호스팅할 수 있으며, keyLocation 변수로 위치를 지정하여 각 IndexNow 알림에서 이 텍스트 키 파일의 위치를 ​​검색 엔진에 알려야 합니다.

URL을 제출하는 경우 keyLocation URL 매개 변수 값으로 키 파일 위치를 지정하세요.

                    https://<searchengine>/indexnow?url=http://www.example.com/product.html&key=&keyLocation=http://www.example.com/myIndexNowKey63638.txt
                

URL 집합을 제출하는 경우 JSON 콘텐츠에서 keyLocation 변수로 키 파일 위치를 지정합니다.

                    POST /indexnow HTTP/1.1
                    Content-Type: application/json; charset=utf-8
                    Host: <searchengine>
                    {
                      "host": "www.example.com",
                      "key": "",
                      "keyLocation": "https://www.example.com/myIndexNowKey63638.txt",
                      "urlList": [
                          "https://www.example.com/url1",
                          "https://www.example.com/folder/url2",
                          "https://www.example.com/url3"
                          ]
                    }
                

이 방법 2에서 키 파일의 위치는 이 키에 포함될 수 있는 URL 집합을 결정합니다. http://example.com/catalog/key12457EDd.txt에 있는 키 파일은 http://example.com/catalog/로 시작하는 모든 URL을 포함할 수 있지만 http://example.com/help/로 시작하는 URL은 포함할 수 없습니다.

http://example.com/catalog/sitemap.xml에서 유효한 것으로 간주되지 않는 URL:

방법 2에서 유효한 것으로 간주되지 않는 URL은 인덱싱에서 고려되지 않을 수 있습니다. 방법 1을 사용하고 파일 키를 웹 서버의 루트 디렉터리에 두는 것이 좋습니다.

Response format


HTTP Code
Response
Reasons
200
OK
URL submitted successfully
202
Accepted
URL received. IndexNow key validation pending.
400
Bad request
Invalid format
403
Forbidden
In case of key not valid (e.g. key not found, file found but key not in the file)
422
Unprocessable Entity
In case of URLs which don’t belong to the host or the key is not matching the schema in the protocol
429
Too Many Requests
Too Many Requests (potential Spam)

Requirement for search engines


Search engines adopting the IndexNow protocol agree that submitted URLs will be automatically shared with all other participating search engines. To participate, search engines must have a noticeable presence in at least one market or be closely linked to the search market and make a significant contribution to the number of url submissions. Learn more