Skip to main content
location reads a page from another country and asks the site for the languages you want. headers sends your own request headers to the site. These fields change what the site shows you, so a read that uses headers, location.languages or skipTlsVerification is always live.

Make a request

Get an API key in the Quickstart. This request reads a page that echoes the headers it received, from Germany, in German, with one custom header.

Read the response

The page lists the headers it got. Two of them are the ones you sent: the languages, best first, and your x-plan header. This real response is cut to those two headers.

Options

Headers

  • Send at most 30 headers.
  • A name uses letters, digits and -, up to 64 characters. A value is up to 2,000 printable characters with no line breaks.
  • Host, Content-Length, Connection, Transfer-Encoding, Upgrade, TE and Proxy-Authorization are refused, because Stophy sets them itself.
  • Your Stophy API key belongs in the Authorization header of your request to Stophy, not in headers.
  • Send Cookie or Authorization only for a site you are allowed to read as that user.

Limits and errors

  • A country that is not a two-letter code returns 400 invalidRequest with the message country: Expected a two-letter country code such as DE.
  • The country is a request. A site can still show the same page to everyone.
  • A read with headers, location.languages or skipTlsVerification is never answered from a stored copy and never saved as one. See Freshness and caching.
  • A refused header returns 400 invalidRequest with the message Stophy sets this header itself.

Price

$1 per 1,000 pages. A country, languages, headers and skipTlsVerification add nothing.