Crawlora
Open navigation
Sign inTry Playground Console
Docs menu

Crawlora Docs

cURL Examples

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

Try Playground TypeScript examples

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.

TypeScriptPythonGo