Get an API key for your agent, no signup required

curl --request POST \
  --url https://app.zenrows.com/api/agent/signup \
  --header 'Content-Type: application/json' \
  --data '
{
  "challenge_id": "<string>",
  "answer": "<string>"
}
'

import requests

url = "https://app.zenrows.com/api/agent/signup"

payload = {
    "challenge_id": "<string>",
    "answer": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({challenge_id: '<string>', answer: '<string>'})
};

fetch('https://app.zenrows.com/api/agent/signup', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://app.zenrows.com/api/agent/signup';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({challenge_id: '<string>', answer: '<string>'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.zenrows.com/api/agent/signup"

	payload := strings.NewReader("{\n  \"challenge_id\": \"<string>\",\n  \"answer\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.zenrows.com/api/agent/signup",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'challenge_id' => '<string>',
    'answer' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://app.zenrows.com/api/agent/signup")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"challenge_id\": \"<string>\",\n  \"answer\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

HttpResponse<String> response = Unirest.post("https://app.zenrows.com/api/agent/signup")
  .header("Content-Type", "application/json")
  .body("{\n  \"challenge_id\": \"<string>\",\n  \"answer\": \"<string>\"\n}")
  .asString();

{
  "apiKey": "8d1c2e9f0a7b4c3d5e6f7a8b9c0d1e2f3a4b5c6d",
  "accountId": "3f2b8c1e-5a4d-4e7f-9b6a-1c2d3e4f5a6b",
  "claimUrl": "https://app.zenrows.com/claim/q7Rk2LmX9pTz?utm_source=agent",
  "trialEndsAt": "2026-11-15T10:00:00+00:00"
}

{
  "message": "To create a Zenrows account, answer: which of norway, walrus, pear is a country? Run: curl -X POST https://app.zenrows.com/api/agent/signup -d c=f4261db6 -d a=ANSWER",
  "error": "challenge_required",
  "challenge": {
    "id": "f4261db6",
    "prompt": "which of norway, walrus, pear is a country?",
    "expires_in": 600
  }
}

{
  "error": "challenge_required",
  "message": "<string>"
}

{
  "error": "challenge_required",
  "message": "<string>"
}

{
  "error": "challenge_required",
  "message": "<string>"
}

Onboarding

Get an API key for your agent, no signup required

Start using Zenrows from your agent without signing up. This call returns a working API key straight away: no account setup, no login, no payment details. The key works right away on the free plan. The account is on the Free plan from signup: 5,000 credits per month, renewed monthly. A person who wants to own it opens claimUrl and claims it; the same key keeps working.

Contract published at https://app.zenrows.com/agent-onboarding/auth.md, and advertised as agent_auth.signup_endpoint in https://app.zenrows.com/.well-known/oauth-protected-resource.

POST

api

agent

signup

Get an API key for your agent, no signup required

curl --request POST \
  --url https://app.zenrows.com/api/agent/signup \
  --header 'Content-Type: application/json' \
  --data '
{
  "challenge_id": "<string>",
  "answer": "<string>"
}
'

import requests

url = "https://app.zenrows.com/api/agent/signup"

payload = {
    "challenge_id": "<string>",
    "answer": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({challenge_id: '<string>', answer: '<string>'})
};

fetch('https://app.zenrows.com/api/agent/signup', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://app.zenrows.com/api/agent/signup';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({challenge_id: '<string>', answer: '<string>'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.zenrows.com/api/agent/signup"

	payload := strings.NewReader("{\n  \"challenge_id\": \"<string>\",\n  \"answer\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.zenrows.com/api/agent/signup",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'challenge_id' => '<string>',
    'answer' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://app.zenrows.com/api/agent/signup")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"challenge_id\": \"<string>\",\n  \"answer\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

HttpResponse<String> response = Unirest.post("https://app.zenrows.com/api/agent/signup")
  .header("Content-Type", "application/json")
  .body("{\n  \"challenge_id\": \"<string>\",\n  \"answer\": \"<string>\"\n}")
  .asString();

{
  "apiKey": "8d1c2e9f0a7b4c3d5e6f7a8b9c0d1e2f3a4b5c6d",
  "accountId": "3f2b8c1e-5a4d-4e7f-9b6a-1c2d3e4f5a6b",
  "claimUrl": "https://app.zenrows.com/claim/q7Rk2LmX9pTz?utm_source=agent",
  "trialEndsAt": "2026-11-15T10:00:00+00:00"
}

{
  "message": "To create a Zenrows account, answer: which of norway, walrus, pear is a country? Run: curl -X POST https://app.zenrows.com/api/agent/signup -d c=f4261db6 -d a=ANSWER",
  "error": "challenge_required",
  "challenge": {
    "id": "f4261db6",
    "prompt": "which of norway, walrus, pear is a country?",
    "expires_in": 600
  }
}

{
  "error": "challenge_required",
  "message": "<string>"
}

{
  "error": "challenge_required",
  "message": "<string>"
}

{
  "error": "challenge_required",
  "message": "<string>"
}

Headers

X-ZR-Agent-Id

string

Optional provenance, anonymous and free of personal data.

X-ZR-Client

string

Optional name of the calling client.

X-ZR-Source

string

Optional origin of the signup.

Body

No fields are required. An empty body is the normal call. After a 428, send the question's id and your answer.

challenge_id

string

The challenge.id from a 428 response.

answer

string

Your answer to challenge.prompt. Case and punctuation do not matter.

Response

The account exists and the key works immediately.

apiKey

string

required

Pass it as the apikey query parameter to Fetch, or as X-API-Key to Batch.

accountId

string<uuid>

required

claimUrl

string<uri>

required

Where a person claims the account to own it. Show this link to a human; do not sit on it.

trialEndsAt

string<date-time>

required

End of the first monthly period (signup + 1 month). The Free plan renews monthly; this value is not refreshed.

Get Started

Fetch

Extract

Crawl

Batch

Account

Onboarding

Get an API key for your agent, no signup required

Headers

Body

Response