Fetch rendered web content
litescrape.web.fetchFetch a public HTTP(S) page and return LLM-ready content
- Price
- $0.00015/successAu prix du fournisseur
- Success rate
- 73,1 %Last 30 days · 21 047 calls
- Latency p50
- 7.8 sp95 28 s
- Last verified
- 29 sept. 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.web.fetch?url=https%3A%2F%2Fexample.com&respond_with=markdownPreview- Uses platform quota
- Synchronous response
- Reads public data
Paramètres
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Paramètres de requête | ||||
url | chaîne | Obligatoire | Public HTTP(S) URL to capture, 1-8,192 characters. Include http:// or https://; bare domains are rejected. The host must be public, on port 80 or 443, without embedded credentials. | https://example.com |
base | chaîne | Facultatif | Resolve relative links against the requested URL (initial, default) or the final URL after redirects (final). | |
engine | chaîne | Facultatif | auto (default; lightweight HTTP first, a browser when needed), browser, or curl (no JavaScript). | |
locale | chaîne | Facultatif | Browser locale as a language tag, 2-64 characters. Defaults to the browser's own. | en-US |
no_gfm | chaîne | Facultatif | true, false or table: disable GitHub-flavored Markdown, or only its tables. | |
preset | chaîne | Facultatif | Option preset. Fills only the options the request leaves unset. | |
referer | chaîne | Facultatif | HTTP(S) URL sent as the Referer. | https://example.com |
timeout | nombre | Facultatif | Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline. | |
max_tokens | entier | Facultatif | Integer 500-10,000,000. Trim content to this many tokens. | |
robots_txt | chaîne | Facultatif | User agent, 1-256 characters, to check against the site's robots.txt; disallowed URLs are rejected. | MyBot |
user_agent | chaîne | Facultatif | User-Agent for the page request, 1-1,024 characters without control characters. Defaults to the browser's own. | |
with_iframe | chaîne | Facultatif | true, false or quoted: include iframe content before extraction. | |
page_timeout | entier | Facultatif | Seconds from 1 through 180 for page loading and browser operations. Cannot extend the total request budget set by timeout. | 30 |
respond_with | chaîne | Facultatif | Output format: content (default; main content as Markdown, or the whole page when extraction keeps too little), markdown (whole page as Markdown), html, text, frontmatter (content plus front matter), or a '+' combination such as markdown+frontmatter. For screenshots use /api/web/screenshot. | markdown |
retain_links | chaîne | Facultatif | Links to keep: all (default), text (link text only), none, or gpt-oss (citation format with a links summary). | |
retain_media | chaîne | Facultatif | How video, audio and embedded video appear: none, text, link (default), image or html. | |
token_budget | entier | Facultatif | Integer 1-10,000,000. Reject the page when its token count exceeds the budget. | |
retain_images | chaîne | Facultatif | Images to keep: all (default), alt (alt text only) or none. | alt |
remove_overlay | booléen | Facultatif | Remove modal and cookie-banner overlays from the page. | |
respond_timing | chaîne | Facultatif | Page readiness condition to reach before responding. | network-idle |
remove_selector | chaîne | Facultatif | CSS selector removed before extraction, 1-2,048 characters; POST also accepts a list of 1-16 selectors. | nav, footer |
target_selector | chaîne | Facultatif | CSS selector to extract, 1-2,048 characters; POST also accepts a list of 1-16 selectors. Implies waiting for the selector. Match-all selectors are rejected. | article |
with_shadow_dom | booléen | Facultatif | Include open shadow DOM content before extraction. | |
detach_invisibles | booléen | Facultatif | Drop display:none elements from the page. | |
keep_img_data_url | booléen | Facultatif | Keep inline data: images in Markdown. | |
markdown_chunking | chaîne | Facultatif | true, h1-h5, structured or s1-s5: split the Markdown and return chunks. | |
wait_for_selector | chaîne | Facultatif | CSS selector to wait for after navigation, 1-2,048 characters. POST also accepts a list of 1-16 selectors. | main |
assert_status_code | entier | Facultatif | Expected origin HTTP status, 100-599. A different status is rejected; otherwise a rendered error page is a successful capture. | 200 |
with_links_summary | chaîne | Facultatif | true, false or all: add a links list to the response. | |
with_images_summary | booléen | Facultatif | Add an images list to the response. | |
- Paramètres de requête
urlchaîneObligatoirePublic HTTP(S) URL to capture, 1-8,192 characters. Include http:// or https://; bare domains are rejected. The host must be public, on port 80 or 443, without embedded credentials.
Exemple :
https://example.combasechaîneFacultatifResolve relative links against the requested URL (initial, default) or the final URL after redirects (final).
enginechaîneFacultatifauto (default; lightweight HTTP first, a browser when needed), browser, or curl (no JavaScript).
localechaîneFacultatifBrowser locale as a language tag, 2-64 characters. Defaults to the browser's own.
Exemple :
en-USno_gfmchaîneFacultatiftrue, false or table: disable GitHub-flavored Markdown, or only its tables.
presetchaîneFacultatifOption preset. Fills only the options the request leaves unset.
refererchaîneFacultatifHTTP(S) URL sent as the Referer.
Exemple :
https://example.comtimeoutnombreFacultatifOptional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
max_tokensentierFacultatifInteger 500-10,000,000. Trim content to this many tokens.
robots_txtchaîneFacultatifUser agent, 1-256 characters, to check against the site's robots.txt; disallowed URLs are rejected.
Exemple :
MyBotuser_agentchaîneFacultatifUser-Agent for the page request, 1-1,024 characters without control characters. Defaults to the browser's own.
with_iframechaîneFacultatiftrue, false or quoted: include iframe content before extraction.
page_timeoutentierFacultatifSeconds from 1 through 180 for page loading and browser operations. Cannot extend the total request budget set by timeout.
Exemple :
30respond_withchaîneFacultatifOutput format: content (default; main content as Markdown, or the whole page when extraction keeps too little), markdown (whole page as Markdown), html, text, frontmatter (content plus front matter), or a '+' combination such as markdown+frontmatter. For screenshots use /api/web/screenshot.
Exemple :
markdownretain_linkschaîneFacultatifLinks to keep: all (default), text (link text only), none, or gpt-oss (citation format with a links summary).
retain_mediachaîneFacultatifHow video, audio and embedded video appear: none, text, link (default), image or html.
token_budgetentierFacultatifInteger 1-10,000,000. Reject the page when its token count exceeds the budget.
retain_imageschaîneFacultatifImages to keep: all (default), alt (alt text only) or none.
Exemple :
altremove_overlaybooléenFacultatifRemove modal and cookie-banner overlays from the page.
respond_timingchaîneFacultatifPage readiness condition to reach before responding.
Exemple :
network-idleremove_selectorchaîneFacultatifCSS selector removed before extraction, 1-2,048 characters; POST also accepts a list of 1-16 selectors.
Exemple :
nav, footertarget_selectorchaîneFacultatifCSS selector to extract, 1-2,048 characters; POST also accepts a list of 1-16 selectors. Implies waiting for the selector. Match-all selectors are rejected.
Exemple :
articlewith_shadow_dombooléenFacultatifInclude open shadow DOM content before extraction.
detach_invisiblesbooléenFacultatifDrop display:none elements from the page.
keep_img_data_urlbooléenFacultatifKeep inline data: images in Markdown.
markdown_chunkingchaîneFacultatiftrue, h1-h5, structured or s1-s5: split the Markdown and return chunks.
wait_for_selectorchaîneFacultatifCSS selector to wait for after navigation, 1-2,048 characters. POST also accepts a list of 1-16 selectors.
Exemple :
mainassert_status_codeentierFacultatifExpected origin HTTP status, 100-599. A different status is rejected; otherwise a rendered error page is a successful capture.
Exemple :
200with_links_summarychaîneFacultatiftrue, false or all: add a links list to the response.
with_images_summarybooléenFacultatifAdd an images list to the response.
Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.web.fetch?url=https%3A%2F%2Fexample.com&respond_with=markdown' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.web.fetch?url=https%3A%2F%2Fexample.com&respond_with=markdown",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.web.fetch?url=https%3A%2F%2Fexample.com&respond_with=markdown", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.00015/success, frais de service inclus.