POST /fetch
Fetch any web page and get it back as clean markdown, HTML, a list of links, or a screenshot. No headless browser infrastructure to manage.
Costs 1 utility call per request.
{
"url": "https://example.com/blog/onboarding-guide",
"formats": ["markdown"],
"only_main_content": true
}
| Field | Type | Required | Description |
|---|---|---|---|
url | string | yes | The URL to fetch |
formats | string[] | no | Output formats: markdown, html, raw_html, links, screenshot |
only_main_content | boolean | no | Strip navigation, footers, etc. (default: false) |
include_tags | string[] | no | Only include these HTML tags |
exclude_tags | string[] | no | Exclude these HTML tags |
wait_for | integer | no | Wait N milliseconds for JS to render |
timeout | integer | no | Request timeout in milliseconds |
mobile | boolean | no | Use a mobile viewport |
headers | object | no | Custom HTTP headers to send |
{
"url": "https://example.com/blog/onboarding-guide",
"source_url": "https://example.com/blog/onboarding-guide",
"markdown": "# The Complete Guide to User Onboarding\n\nOnboarding is the first...",
"metadata": {
"title": "The Complete Guide to User Onboarding",
"description": "Learn how to build onboarding flows that convert",
"language": "en",
"status_code": 200,
"keywords": ["onboarding", "SaaS", "user experience"]
}
}
| Field | Type | Description |
|---|---|---|
url | string | The URL that was fetched |
source_url | string | The final URL after redirects |
markdown | string | Page content as markdown (if requested) |
html | string | Page content as clean HTML (if requested) |
raw_html | string | Original HTML (if requested) |
links | string[] | All links on the page (if requested) |
screenshot_url | string | URL of a screenshot (if requested) |
metadata | object | Page metadata |
curl -X POST https://api.noodlespy.com/fetch \
-H "Authorization: Bearer nspy_your_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/blog/post",
"formats": ["markdown"],
"only_main_content": true
}'
curl -X POST https://api.noodlespy.com/fetch \
-H "Authorization: Bearer nspy_your_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/resources",
"formats": ["links"]
}'
| Status | Cause |
|---|---|
422 | URL is unreachable or returned an error |
504 | Page took too long to load |