ZenRows is an Elixir client library for interacting with the ZenRows API. It provides a simple and convenient way to send HTTP requests to the ZenRows API, allowing you to scrape web pages and extract data easily.

View the documentation.

Add zenrows to your list of dependencies in mix.exs:

def deps do
  [
    {:zenrows, "~> 0.1"}
  ]
end

Then run mix deps.get to install the dependency.

Configure the zenrows library by adding the following to your config.exs file:

config :zenrows,
  api_key: "YOUR_API_KEY",
  adapter: Tesla.Adapter.Hackney,
  retries: 3,
  delay: 1000,
  max_delay: 10_000,
  timeout: 30_000

• api_key (required): Your ZenRows API key. Get your free API key from the ZenRows dashboard.
• adapter (optional): The HTTP adapter module to use for requests. Default is Tesla.Adapter.Hackney.
• retries (optional): The number of times to retry failed requests. Default is 0.
• delay (optional): The initial delay in milliseconds between retries. Default is 500.
• max_delay (optional): The maximum delay in milliseconds between retries. Default is 4000.
• timeout (optional): The request timeout in milliseconds. Default is 30000.

ZenRows.get("https://example.com", headers: %{"Authorization" => "Bearer token"}, config: %ZenRows.Config{js_render: true})

ZenRows.post("https://example.com", data: %{key: "value"}, headers: %{"Authorization" => "Bearer token"})

• :headers (optional): A map of additional headers to include in the request. Default is an empty map.
• :config (optional): A ZenRows.Config struct specifying the configuration options for the request. Default is an empty struct.
• :data (optional): A map of data to be sent as the request body in a POST request. Default is an empty map.
• :adapter (optional): The HTTP adapter module to use for the request. Default is Tesla.Adapter.Hackney.
• :retries (optional): The number of times to retry failed requests. Overrides the application environment configuration.
• :delay (optional): The initial delay in milliseconds between retries. Overrides the application environment configuration.
• :max_delay (optional): The maximum delay in milliseconds between retries. Overrides the application environment configuration.
• :timeout (optional): The request timeout in milliseconds. Overrides the application environment configuration.

For more information on the available configuration options, refer to the ZenRows.Config documentation.

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.

ZenRows is released under the MIT License. See the LICENSE file for more information.