Pricing
$0.0003 / grab
Grabs are sold by the grab bag each of which contains 16,667 grabs for $5.00 plus tax (USD). Any number of grab bags may be purchased. One grab is a single request for a single URL.
Frequently Asked Questions
Which formats are supported?
LinkGrabs can fetch a web page as a Screengrab (PNG, JPG, or WEBP), Rendered DOM HTML, PDF, or as a MHTML web archive.
Can I try before buying?
New accounts come with 5,000 free grabs. To get 15,000 free trial grabs send an email to trial@linkgrabs.com with your account ID in the subject line. Please allow up to 24 hours for trial provisioning.
How do Account IDs work?
Account IDs are randomly and securely generated. You will only be shown your Account ID once, so write it down immediately or you will lose access to any purchased grabs. Account IDs cannot be merged, recovered, or otherwise changed.
API
The LinkGrab.com API has a single endpoint. It is located at https://linkgrabs.com/grab.
Only POST requests are accepted and the URL to be grabbed must be sent as the request body.
To indicate the type of grab you would like performed add the parameter t to the query string and pass the type.
Optionally, you may specify the file format for a screengrab by adding the parameter f to the query string and passing the format.
cURL Examples
PNG Screengrab
curl -X POST https://linkgrabs.com/grab?t=screengrab&f=png -d "http://example.com" -H "x-linkgrab-auth: <account-id>"
HTML Grab
curl -X POST https://linkgrabs.com/grab?t=html -d "http://example.com" -H "x-linkgrab-auth: <account-id>"
MHTML Grab
curl -X POST https://linkgrabs.com/grab?t=mhtml -d "http://example.com" -H "x-linkgrab-auth: <account-id>"
JPEG Grab
curl -X POST https://linkgrabs.com/grab?t=screengrab&f=jpeg&v=2560x1440 -d "http://example.com"-H "x-linkgrab-auth: <account-id>"
PDF Grab
curl -X POST https://linkgrabs.com/grab?t=pdf -d "http://example.com" -H "x-linkgrab-auth: <account-id>;"
Viewport
For screengrabs and PDFs you may specify the viewport size by adding the parameter v to the query string and passing the size as WidthxHeight e.g. 1920x1080.
?t=screengrab&f=jpg&v=2560x1440 will grab a 2560x1440 JPG screengrab.
The height should be considered a minimum. The actual height will be the height of the content plus the height of the viewport.
Authentication
Your Account ID is used to authenticate your requests via a custom HTTP header named x-linkgrab-auth.
x-linkgrab-auth: <account-id>
Endpoints
HTML: https://linkgrabs.com/grab?t=html
MHTML: https://linkgrabs.com/grab?t=mhtml
JPG: https://linkgrabs.com/grab?t=screengrab&f=jpg
JPEG: https://linkgrabs.com/grab?t=screengrab&f=jpeg
PNG: https://linkgrabs.com/grab?t=screengrab&f=png
WebP: https://linkgrabs.com/grab?t=screengrab&f=webp
PDF: https://linkgrabs.com/grab?t=pdf