Skip to content

Crawlee—A web scraping and browser automation library for Node.js to build reliable crawlers. In JavaScript and TypeScript. Extract data for AI, LLMs, RAG, or GPTs. Download HTML, PDF, JPG, PNG, and other files from websites. Works with Puppeteer, Playwright, Cheerio, JSDOM, and raw HTTP. Both headful and headless mode. With proxy rotation.

Improve docs [skip ci]

Ondra Urban9ca2019c3a08
diff --git a/docs/api/Apify.md b/docs/api/Apify.md
index e74aab892..e70a41071 100644
--- a/docs/api/Apify.md
+++ b/docs/api/Apify.md
@@ -437,13 +437,14 @@ For more information, see the <a href="https://my.apify.com/proxy" target="_blan
<td><code>[options.country]</code></td><td><code>String</code></td>
</tr>
<tr>
-<td colspan="3"><p>If specified, all proxied requests will use IP addresses that geolocated to the specified country.
-For example country-GB for IP&#39;s from Great Britain.
+<td colspan="3"><p>If specified, all proxied requests will use IP addresses that are geolocated to the specified country.
+For example <code>GB</code> for IPs from Great Britain. Note that online services often have their own rules for handling geolocation and thus
+the country selection is a best attempt at geolocation, rather than a guaranteed hit.
This parameter is optional, by default, each proxied request is assigned an IP address from a random country.
The country code needs to be a two letter ISO country code
- see the <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements" target="_blank">
full list of available country codes
-</a></p>
+</a>.</p>
<p>This parameter is optional, by default, the proxy uses all available proxy servers from all countries.</p>
</td></tr></tbody>
</table>
diff --git a/src/actor.js b/src/actor.js
index ad422959f..262af13b7 100644
--- a/src/actor.js
+++ b/src/actor.js
@@ -711,13 +711,14 @@ export const metamorph = async (targetActorId, input, options = {}) => {
* All HTTP requests going through the proxy with the same session identifier
* will use the same target proxy server (i.e. the same IP address), unless using Residential proxies.
* The identifier can only contain the following characters: `0-9`, `a-z`, `A-Z`, `"."`, `"_"` and `"~"`.
- * @param {String} [options.country] If specified, all proxied requests will use IP addresses that geolocated to the specified country.
- * For example country-GB for IP's from Great Britain.
+ * @param {String} [options.country] If specified, all proxied requests will use IP addresses that are geolocated to the specified country.
+ * For example `GB` for IPs from Great Britain. Note that online services often have their own rules for handling geolocation and thus
+ * the country selection is a best attempt at geolocation, rather than a guaranteed hit.
* This parameter is optional, by default, each proxied request is assigned an IP address from a random country.
* The country code needs to be a two letter ISO country code
* \- see the <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements" target="_blank">
- *full list of available country codes
- *</a>
+ * full list of available country codes
+ * </a>.
*
* This parameter is optional, by default, the proxy uses all available proxy servers from all countries.
*