Jina Search Foundation API

r.jina.ai를 사용하여 URL을 읽고 해당 내용을 가져옵니다.

s.jina.ai로 웹을 검색하고 SERP를 얻으세요

LLM에서 당사 API를 사용할 수 있도록 mcp.jina.ai를 MCP 서버로 추가하세요

매개변수

더 높은 속도 제한을 위해 API 키 추가

더 높은 속도 제한을 사용하려면 Jina API 키를 입력하세요. 최신 속도 제한 정보는 아래 표를 참조하세요.더 알아보기

브라우저 엔진(품질/속도)

X-Engine

웹 콘텐츠를 검색하는 데 사용되는 브라우저 엔진을 선택하세요. 이는 콘텐츠의 품질, 속도, 완전성 및 접근성에 영향을 미칩니다.더 알아보기

기본

콘텐츠 형식

Return-Format

과도한 필터링을 방지하기 위해 응답의 세부 정보 수준을 제어할 수 있습니다. 기본 파이프라인은 대부분의 사이트와 대규모 모델 입력에 맞게 최적화되어 있습니다.

기본

JSON 응답

응답은 JSON 형식이며 URL, 제목, 콘텐츠, 타임스탬프(사용 가능한 경우)를 포함합니다. 검색 모드에서는 각각 위에서 설명한 JSON 구조를 따르는 5개 항목의 목록을 반환합니다.

타임아웃(초)

X-Timeout

페이지 로딩 최대 대기 시간입니다. 페이지 로딩 속도가 느린 경우 이 값을 늘리고, 단순하고 정적인 페이지의 경우 이 값을 줄이세요.

토큰예산

X-Token-Budget

이 요청에 사용되는 최대 토큰 수를 제한합니다. 이 제한을 초과하면 요청이 실패하게 됩니다.

ReaderLM-v2 사용

실험

X-Respond-With

ReaderLM-v2를 사용하여 HTML을 Markdown으로 변환하면 구조와 콘텐츠가 복잡한 웹 사이트에 고품질 결과를 제공할 수 있습니다. 다른 엔진보다 3배 더 많은 토큰을 소모합니다!더 알아보기

지정 영역만 추출 (CSS 선택자)

X-Target-Selector

다음 CSS 선택자와 일치하는 콘텐츠만 추출하세요. 예: article, .main-content, #post-body

대기 대상 (CSS 선택자)

X-Wait-For-Selector

이러한 요소들이 나타난 후에만 콘텐츠를 추출하세요. 이는 동적으로 로드되는 콘텐츠에 매우 유용합니다.

제외 (CSS 선택자)

X-Remove-Selector

추출 전에 이러한 요소를 제거합니다. 예: nav, footer, .sidebar, #ads

모든 이미지 제거

X-Retain-Images

출력에서 모든 이미지를 제거합니다. 이렇게 하면 이미지가 필요하지 않을 때 토큰 사용량을 줄일 수 있습니다.

OpenAI 인용 형식

X-Retain-Links

OpenAI 웹 브라우징 도구에 맞는 링크 형식을 지정하세요. GPT 모델과 호환되는 특수 참조 태그를 사용하세요.더 알아보기

링크 요약 섹션

X-With-Links-Summary

마지막으로 "버튼 및 링크" 섹션이 생성됩니다. 이는 다운스트림의 대규모 모델이나 웹 에이전트가 페이지를 탐색하거나 추가 작업을 수행하는 데 도움이 될 수 있습니다.

없음

이미지 요약 섹션

X-With-Images-Summary

마지막으로 "그림" 섹션이 생성됩니다. 이를 통해 다운스트림의 대규모 모델이 페이지의 모든 시각적 요소를 살펴볼 수 있어 추론 능력이 향상됩니다.

없음

브라우저 뷰포트 크기

POST

viewport

브라우저 창 크기를 설정합니다. 반응형 레이아웃 및 콘텐츠 표시 여부에 영향을 미칩니다.더 알아보기

쿠키 전달

X-Set-Cookie

당사의 API 서버는 URL에 액세스할 때 사용자 정의 쿠키 설정을 전달할 수 있으며 이는 추가 인증이 필요한 페이지에 유용합니다. 쿠키가 포함된 요청은 캐시되지 않습니다.더 알아보기

이미지 캡션

X-With-Generated-Alt

지정된 URL에 있는 모든 이미지에 캡션을 추가하고, 캡션이 없는 이미지에 "이미지 [idx]: [캡션]"을 alt 태그로 추가합니다. 이를 통해 대규모 다운스트림 모델은 추론 및 요약과 같은 활동 중에 이미지와 상호 작용할 수 있습니다.

프록시 서버 사용

X-Proxy-Url

당사의 API 서버는 귀하의 프록시를 활용하여 URL에 액세스할 수 있는데, 이는 특정 프록시를 통해서만 액세스할 수 있는 페이지에 유용합니다.더 알아보기

국가별 프록시 서버를 사용하세요

X-Proxy

위치 기반 프록시 서버의 국가 코드를 설정합니다. 최적 선택은 'auto', 비활성화는 'none'을 사용하세요.

캐싱 우회

X-No-Cache

저희 API는 일정 시간 동안 URL 콘텐츠를 캐시합니다. 캐시된 결과를 무시하고 URL에서 직접 콘텐츠를 가져오려면 true로 설정하세요.

캐시 허용 시간(초)

X-Cache-Tolerance

캐시된 콘텐츠가 N초 이내에 게시된 경우 캐시된 콘텐츠가 허용됩니다. 값을 0으로 설정하면 최신 콘텐츠를 허용하는 것(캐시를 무시하는 것과 동일)이며, 더 높은 값으로 설정하면 캐시에서 더 빠른 응답을 가져올 수 있습니다.

페이지 준비 시간

X-Respond-Timing

페이지가 완전히 로드된 것으로 간주되는 시점은 언제인가요? 후자의 타이밍 측정 방식은 시간이 더 오래 걸리지만 더 많은 동적 콘텐츠를 포착합니다.

기본

사용자 지정 사용자 에이전트

X-User-Agent

브라우저 사용자 에이전트 문자열을 재정의합니다. 특정 브라우저를 필요로 하거나 웹 크롤러를 차단하는 웹사이트에 접속할 때 매우 유용합니다.

사용자 지정 Referer

X-Referer

HTTP Referer 헤더를 설정하세요. 일부 웹사이트는 트래픽이 예상한 출처에서 왔는지 확인하기 위해 이 헤더를 확인합니다.

Base64 이미지 저장

X-Keep-Img-Data-Url

인라인으로 삽입된 base64 인코딩 이미지를 외부 URL로 변환하는 대신, 마크다운 출력에 그대로 유지하세요.

캐시 또는 추적을 하지 마세요.

DNT

이 요청이 당사 서버에 캐시되거나 기록되지 않도록 합니다. 민감한 URL에 사용하세요.

Github 스타일 마크다운

X-No-Gfm

GFM(Github Flavored Markdown) 기능을 옵트인/아웃합니다.

활성화됨

스트리밍 모드

스트림 모드는 대상 페이지가 클 때 유용하며, 페이지가 완전히 렌더링될 때까지 더 오래 기다립니다. 표준 모드에서 콘텐츠가 불완전하다면 스트림 모드 사용을 고려해 보세요.더 알아보기

브라우저 로케일 사용자 지정

X-Locale

페이지 렌더링을 위한 브라우저 로캘 설정을 제어합니다. 많은 웹사이트는 로캘 설정에 따라 다양한 콘텐츠를 제공합니다.더 알아보기

robots.txt 준수

X-Robots-Txt

콘텐츠를 가져오기 전에 robots.txt 규칙을 확인합니다. 확인에 사용할 봇 이름을 지정하세요.

iframe 콘텐츠 포함

X-With-Iframe

내장된 iframe에서 콘텐츠를 추출합니다. iframe 안에 콘텐츠가 로드되는 페이지에서 활성화하세요.

Shadow DOM 포함

X-With-Shadow-Dom

Shadow DOM 컴포넌트에서 콘텐츠를 추출합니다. 웹 컴포넌트를 사용하는 페이지에서 활성화하세요.

최종 URL을 기준으로 삼으세요.

X-Base

상대 URL을 해석할 때는 원래 URL이 아닌 리디렉션 후 최종 대상 URL을 사용하십시오.

로컬 PDF/HTML 파일

POST

로컬 PDF 및 HTML 파일을 업로드하여 Reader로 읽을 수 있습니다. pdf와 html 파일만 지원됩니다. HTML의 경우 관련 CSS/JS 스크립트를 더 잘 파싱할 수 있도록 참조 URL도 함께 지정해 주세요.

추출 전에 JavaScript를 실행하세요

POST

콘텐츠를 추출하기 전에 사용자 지정 JavaScript 코드를 실행하여 페이지를 수정하세요. 이 코드는 인라인 코드이거나 스크립트 파일을 가리키는 URL일 수 있습니다.더 알아보기

제목 스타일

X-Md-Heading-Style

마크다운 제목 형식을 설정합니다(Turndown에 전달됨).

해시 스타일

수평선 스타일

X-Md-Hr

마크다운 수평선 형식을 정의합니다(Turndown에 전달됨).

글머리 기호 스타일

X-Md-Bullet-List-Marker

글머리 기호 목록 표시 문자를 설정합니다(Turndown에 전달됨).

강조 스타일

X-Md-Em-Delimiter

마크다운 강조 구분 기호를 정의합니다(Turndown에 전달됨).

강한 강조 스타일

X-Md-Strong-Delimiter

마크다운 강한 강조 구분 기호를 설정합니다(Turndown에 전달됨).

링크 스타일

X-Md-Link-Style

마크다운 링크 형식을 결정합니다(Turndown에 전달됨).

인라인

EU 데이터 소재지

실험

활성화하면 이 요청의 인프라와 데이터 처리가 EU 내에 위치합니다.

curl "https://r.jina.ai/https://www.example.com"