Skip to content
Gridlode
Docs · Reference

Page HTML

GET /v1/url/html1 credit / requestcache 60 min

The raw HTML of any public web page with final URL, status code, redirect chain and key headers. Respects robots.txt by default. Failed fetches (blocks, 5xx, timeouts) are not charged.

Query parameters

url
string · required
Public http(s) URL to fetch.
respect_robots
boolean
Refuse URLs disallowed by the site's robots.txt.
Default: true
render
boolean
Render JavaScript in real Chrome first (+1 credit). Images, media and fonts are skipped.
Default: false
wait_ms
integer
With render=true: extra wait after load for late content.
Default: 1000
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

  • final_url / redirects · Where the request ended up and every hop on the way.
  • status_code / content_type · HTTP status and media type of the final response.
  • headers · content-type, content-language, last-modified, cache-control, x-robots-tag, server, etag when present.
  • html · The HTML exactly as the server sent it (up to 5 MB).
  • robots · allowed, unavailable (no robots.txt reachable) or ignored.

Example

curl "https://api.gridlode.com/v1/url/html?url=https%3A%2F%2Fexample.com%2F" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

Try it without code on the Page HTML API page.