{"id":113,"date":"2020-03-08T03:25:00","date_gmt":"2020-03-08T11:25:00","guid":{"rendered":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/?p=113"},"modified":"2020-06-11T08:35:52","modified_gmt":"2020-06-11T16:35:52","slug":"geoscreenshot-api-beta","status":"publish","type":"post","link":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/","title":{"rendered":"GeoScreenshot API Beta"},"content":{"rendered":"\n<p>We&#8217;ve released an early version of the GeoScreenshot 2 API for our advanced plan users. Here is a brief tutorial on how to get started.<\/p>\n\n\n\n<h3>Step 1. Generate an API Key<\/h3>\n\n\n\n<p>Your API key is private and <strong>should not be shared with another person<\/strong>. If you need to create multiple API keys for different applications or users on your team, Geo allows you to create multiple keys and manage them individually.<br><br>Navigate to My Account: <\/p>\n\n\n\n<p>https:\/\/www.geoscreenshot.com\/userarea\/account\/api<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"355\" src=\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image-1024x355.png\" alt=\"\" class=\"wp-image-114\" srcset=\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image-1024x355.png 1024w, https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image-300x104.png 300w, https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image-768x266.png 768w, https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image-1536x532.png 1536w, https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image.png 1617w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<h3>Step 2. Make a request to the screenshot endpoint with your API key<\/h3>\n\n\n\n<p>URL: <strong>https:\/\/api.geoscreenshot.com\/screenshot?<\/strong><\/p>\n\n\n\n<p><strong>Query String Params:<\/strong><\/p>\n\n\n\n<ul><li><strong>apikey &#8211; Api key from dashboard<\/strong><\/li><li><strong>url &#8211; A valid HTTP\/S URL<\/strong><\/li><li><strong>country &#8211;<a rel=\"noreferrer noopener\" href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Officially_assigned_code_elements\" target=\"_blank\"> Alpha 2 country code<\/a> (Required)<\/strong><\/li><\/ul>\n\n\n\n<h4>Advanced capture settings<\/h4>\n\n\n\n<ul><li>user_agent &#8211; 1 or 0, User agent string override (Optional , defaults to Google Chrome)<\/li><li>full_page &#8211; 1 or 0, Capture the full height of the page (Optional , defaults to 0) <\/li><li>local_tz &#8211; 1 or 0, Use local timezone (Optional , defaults to 1)<\/li><li>local_html5_geolocation &#8211; 1 or 0, Use local HTML5 geolocation (Optional , defaults to 1)<\/li><li>width &#8211; Viewport width (Optional, defaults to 1280px)<\/li><li>height &#8211; Viewport height (Optional, defaults to 1024px)<\/li><\/ul>\n\n\n\n<h4>Advanced location settings<\/h4>\n\n\n\n<ul><li>metro_id &#8211; Specific metropolitan area, can be fetched from the following public endpoint; <a href=\"https:\/\/api.geoscreenshot.com\/location\">https:\/\/api.geoscreenshot.com\/location<\/a><\/li><li>node_id &#8211; Specific VPS node for capture, can also be fetched from the locations endpoint. Alternatively, it can be found on a detailed location page such as the following: <a href=\"https:\/\/www.geoscreenshot.com\/country\/south-africa\/cape-town-western-cape\">https:\/\/www.geoscreenshot.com\/country\/south-africa\/cape-town-western-cape<\/a><\/li><\/ul>\n\n\n\n<h4>Sample Response:<\/h4>\n\n\n\n<pre class=\"wp-block-code\"><code>\"_meta\": {\n        \"uid\": \"fabd8fa3-c4aa-4a0f-9894-a3580b31ec74\",\n        \"startTime\": 1591611008242,\n        \"endTime\": 1591611020878,\n        \"duration\": 12636,\n        \"instanceId\": \"516e8d0cbddbf6b25f4d0218f87336ec_0\"\n    },\n    \"_hash\": {\n        \"perceptual\": \"b00c07ef7cf7b001f0c7f0417071f07330f17bf1f00731c1fff03000f040f3f3\",\n        \"html\": \"15e0cdc83fe612e296339b958f9d6934c8d056908a5b47f31f92bce740e60843\",\n        \"png\": \"9a93408fe05bc13d71db4220039a5f3454de19a1078f5bbc2825fc5391ead329\",\n        \"console\": \"83f976263ba5eece3baa5ec655439f41257dd62f1d55dfd66b98d08eac97345b\",\n        \"har\": \"14d08a710f8d35fb498c218d959841dcdfa835ff92ef3a8dd1ed7f3e84590f53\",\n        \"cookies\": \"b13ab3f6a59045b8ca7031e0032618280b3d49749902d1f255a1d0c5ce9de066\"\n    },\n    \"errors\": {\n        \"html\": null,\n        \"png\": null,\n        \"navigate\": null\n    },\n    \"png\": \"https:\/\/s3.amazonaws.com\/geoscreenshot-static\/fabd8fa3-c4aa-4a0f-9894-a3580b31ec74.png\",\n    \"html\": \"https:\/\/s3.amazonaws.com\/geoscreenshot-static\/fabd8fa3-c4aa-4a0f-9894-a3580b31ec74.html\",\n    \"console\": \"https:\/\/s3.amazonaws.com\/geoscreenshot-static\/fabd8fa3-c4aa-4a0f-9894-a3580b31ec74.console.json\",\n    \"har\": \"https:\/\/s3.amazonaws.com\/geoscreenshot-static\/fabd8fa3-c4aa-4a0f-9894-a3580b31ec74.har.json\",\n    \"metrics\": {\n        \"dnsLookup\": 0,\n        \"tcpConnect\": 0,\n        \"request\": 175,\n        \"response\": 917,\n        \"domLoaded\": 3859,\n        \"domInteractive\": 1910,\n        \"pageLoad\": 1,\n        \"fullTime\": 4821\n    },\n    \"cookies\": \"https:\/\/s3.amazonaws.com\/geoscreenshot-static\/fabd8fa3-c4aa-4a0f-9894-a3580b31ec74.cookies.json\",\n    \"ip\": \"69.197.157.130\",\n    \"title\": \"Google News\",\n    \"capture_id\": \"148936\",\n    \"domain\": \"news.google.com\",\n    \"url\": \"https:\/\/news.google.com\",\n    \"metro_id\": \"us_mss_knsscty\",\n    \"node_id\": \"us_mss_kns_1luhIL\",\n    \"options\": \"{}\",\n    \"created_at\": \"2020-06-08T10:10:21.000Z\",\n    \"updated_at\": \"2020-06-08T10:10:21.000Z\"\n}<\/code><\/pre>\n\n\n\n<h3>Step 3. Parse the JSON<\/h3>\n\n\n\n<ul><li>_meta &#8211; Metadata about the capture request lifecycle<\/li><li>_hash &#8211; Hashes of the data returned, including a perceptual hash for similarity indexing<\/li><li>errors &#8211; Any errors encountered during capture<\/li><li>png &#8211; URL to the PNG <\/li><li>html &#8211; URL to the rendered HTML<\/li><li>console &#8211; A JSON of any console messages encountered<\/li><li>har &#8211; HTTP archive waterfall of the requests<\/li><li>metrics &#8211; Page load performance metrics<\/li><li>cookies &#8211; Cookie jar JSON<\/li><li>ip &#8211; The public IP used<\/li><li>title &#8211; The webpage&#8217;s final title at the time of the capture<\/li><li>capture_id &#8211; Internal id used for future reference<\/li><li>domain &#8211; The parsed domain of the URL, used for blacklisting adult sties<\/li><li>url &#8211; The requested URL<\/li><li>metro_id &#8211; The precise metropolitan area used. <strong>You can pass this instead of country to get consistent geo-ip targeting.<\/strong><\/li><li>node_id &#8211; The precise VPS node used to run the capture. <strong>You can pass this instead of metro_id to re-use the same IP multiple times<\/strong><\/li><\/ul>\n\n\n\n<h2>Shortcut Endpoints<\/h2>\n\n\n\n<p><strong>For PNG: <\/strong>https:\/\/api.geoscreenshot.com\/screenshot\/png?apikey=&lt;API_KEY>&amp;url=https:\/\/news.ycombinator.com&amp;country=de<\/p>\n\n\n\n<p><strong>For HTML: <\/strong>https:\/\/api.geoscreenshot.com\/screenshot\/html?apikey=&lt;API_KEY>&amp;url=https:\/\/news.ycombinator.com&amp;country=de&amp;no_precheck<\/p>\n\n\n\n<p><strong>For HAR: <\/strong>https:\/\/api.geoscreenshot.com\/screenshot\/har?apikey=&lt;API_KEY>&amp;url=https:\/\/news.ycombinator.com&amp;country=de&amp;no_precheck<\/p>\n\n\n\n<p><strong>For Console Output: <\/strong>https:\/\/api.geoscreenshot.com\/screenshot\/har?apikey=&lt;API_KEY>&amp;url=https:\/\/news.ycombinator.com&amp;country=de&amp;no_precheck<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We&#8217;ve released an early version of the GeoScreenshot 2 API for our advanced plan users. Here is a brief tutorial on how to get started. Step 1. Generate an API Key Your API key is private and should not be shared with another person. If you need to create multiple API keys for different applications [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v18.5.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>GeoScreenshot API Beta - GeoScreenshot<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"GeoScreenshot API Beta - GeoScreenshot\" \/>\n<meta property=\"og:description\" content=\"We&#8217;ve released an early version of the GeoScreenshot 2 API for our advanced plan users. Here is a brief tutorial on how to get started. Step 1. Generate an API Key Your API key is private and should not be shared with another person. If you need to create multiple API keys for different applications [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/\" \/>\n<meta property=\"og:site_name\" content=\"GeoScreenshot\" \/>\n<meta property=\"article:published_time\" content=\"2020-03-08T11:25:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-06-11T16:35:52+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image-1024x355.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Eyasu Kifle\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#website\",\"url\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/\",\"name\":\"GeoScreenshot\",\"description\":\"Test your website from 100s of locations worldwide\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image.png\",\"contentUrl\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image.png\",\"width\":1617,\"height\":560},{\"@type\":\"WebPage\",\"@id\":\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#webpage\",\"url\":\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/\",\"name\":\"GeoScreenshot API Beta - GeoScreenshot\",\"isPartOf\":{\"@id\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#primaryimage\"},\"datePublished\":\"2020-03-08T11:25:00+00:00\",\"dateModified\":\"2020-06-11T16:35:52+00:00\",\"author\":{\"@id\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#\/schema\/person\/9943ebb4ffce50002d279948ddcfa489\"},\"breadcrumb\":{\"@id\":\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GeoScreenshot API Beta\"}]},{\"@type\":\"Person\",\"@id\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#\/schema\/person\/9943ebb4ffce50002d279948ddcfa489\",\"name\":\"Eyasu Kifle\",\"url\":\"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/author\/eyasu-kifle\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"GeoScreenshot API Beta - GeoScreenshot","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/","og_locale":"en_US","og_type":"article","og_title":"GeoScreenshot API Beta - GeoScreenshot","og_description":"We&#8217;ve released an early version of the GeoScreenshot 2 API for our advanced plan users. Here is a brief tutorial on how to get started. Step 1. Generate an API Key Your API key is private and should not be shared with another person. If you need to create multiple API keys for different applications [&hellip;]","og_url":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/","og_site_name":"GeoScreenshot","article_published_time":"2020-03-08T11:25:00+00:00","article_modified_time":"2020-06-11T16:35:52+00:00","og_image":[{"url":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image-1024x355.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Written by":"Eyasu Kifle","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebSite","@id":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#website","url":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/","name":"GeoScreenshot","description":"Test your website from 100s of locations worldwide","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"ImageObject","@id":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#primaryimage","inLanguage":"en-US","url":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image.png","contentUrl":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-content\/uploads\/2020\/06\/image.png","width":1617,"height":560},{"@type":"WebPage","@id":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#webpage","url":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/","name":"GeoScreenshot API Beta - GeoScreenshot","isPartOf":{"@id":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#website"},"primaryImageOfPage":{"@id":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#primaryimage"},"datePublished":"2020-03-08T11:25:00+00:00","dateModified":"2020-06-11T16:35:52+00:00","author":{"@id":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#\/schema\/person\/9943ebb4ffce50002d279948ddcfa489"},"breadcrumb":{"@id":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/"]}]},{"@type":"BreadcrumbList","@id":"http:\/\/wordpress-210328-1057968.cloudwaysapps.com\/geoscreenshot-api-beta\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/"},{"@type":"ListItem","position":2,"name":"GeoScreenshot API Beta"}]},{"@type":"Person","@id":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/#\/schema\/person\/9943ebb4ffce50002d279948ddcfa489","name":"Eyasu Kifle","url":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/author\/eyasu-kifle\/"}]}},"_links":{"self":[{"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/posts\/113"}],"collection":[{"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/comments?post=113"}],"version-history":[{"count":0,"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/posts\/113\/revisions"}],"wp:attachment":[{"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/media?parent=113"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/categories?post=113"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress-210328-1057968.cloudwaysapps.com\/wp-json\/wp\/v2\/tags?post=113"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}