Docs menu

Crawlora Docs

cURL Examples

Use cURL to test Crawlora endpoints from a terminal before adding code to an application.

Set API key environment variable

Environment

export CRAWLORA_API_KEY="crl_..."

Basic request

This uses the real Google search API endpoint at https://api.crawlora.net/api/v1/google/search.

cURL request

curl -X POST "https://api.crawlora.net/api/v1/google/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us","keyword":"chatgpt","language":"en","limit":10,"page":1}'

Pretty print with jq

Pretty JSON

curl -X POST "https://api.crawlora.net/api/v1/google/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us","keyword":"chatgpt","language":"en","limit":10,"page":1}' | jq .

Save response to a file

Save output

curl -X POST "https://api.crawlora.net/api/v1/google/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us","keyword":"chatgpt","language":"en","limit":10,"page":1}' \
  -o crawlora-response.json

Verbose/debug mode

Verbose cURL

curl -v -X POST "https://api.crawlora.net/api/v1/google/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us","keyword":"chatgpt","language":"en","limit":10,"page":1}'

Example error response

This shape is illustrative. Endpoint docs are the source of truth when a generated failure schema is available.

Illustrative error

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded.",
    "request_id": "req_..."
  }
}

Next steps

Move the request into server-side application code
Add timeouts and retries
Handle 429 and temporary 5xx responses
Open the endpoint docs for request and response schemas

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

Move from terminal to application code

Use the TypeScript, Python, or Go examples for production integration patterns.

TypeScript Python Go