# Get Crawler Details

Retrieve detailed information about a specific crawler including input parameters and output fields

This endpoint retrieves detailed information about a specific crawler using its hash ID. It helps you understand each crawler's availability, cost, parameters, and potential issues before using it.

## Headers

<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

<ParamField header="Content-Type" type="string" default="application/json">
  Content type of the request. Value: `application/json`
</ParamField>

## Path Parameters

<ParamField path="crawler_hash" type="string" required>
  The unique identifier (hash/id) of the crawler. Example: `4734d096159ef05210e0e1677e8be823`
</ParamField>

## Response Field Explanations

<ResponseField name="id" type="string">
  Unique identifier for the crawler. Example: `"c106a44a98044ef18acc59986ae10967"`
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable name (e.g., "Google Maps Search Export"). Example: `"Google Maps (1)"`
</ResponseField>

<ResponseField name="slug" type="string">
  URL-friendly identifier. Example: `"google-maps-leads-scraper"`
</ResponseField>

<ResponseField name="description" type="string">
  What the crawler collects, as shown in the store. Example: `"Give us your properly built Google Maps Search URL(s). Grab all results available. Phone, rating, website included!"`
</ResponseField>

<ResponseField name="help_article" type="string | null">
  Link to the crawler's help article, or `null` when it has none. Example: `null`
</ResponseField>

<ResponseField name="rank" type="integer | null">
  Position in the public store listing. `null` for crawlers that are not ranked. Example: `1`
</ResponseField>

<ResponseField name="is_public" type="boolean">
  Whether the crawler is publicly accessible. Example: `true`
</ResponseField>

<ResponseField name="is_available" type="boolean">
  Whether the crawler is available for runs (false if paused). Example: `true`
</ResponseField>

<ResponseField name="is_premium" type="boolean">
  Requires premium subscription or extra credits. Example: `false`
</ResponseField>

<ResponseField name="has_issues" type="boolean">
  Currently experiencing issues (runs paused until fixed). Example: `false`
</ResponseField>

<ResponseField name="account" type="object | null">
  Required account sync details (null if no authentication needed). Example: `null`
</ResponseField>

<ResponseField name="input" type="array">
  Array of configurable parameters (task-level and squid-level). Example: `[]`
</ResponseField>

<ResponseField name="result" type="array">
  Array of output field names this crawler collects. Example: `[]`
</ResponseField>

<ResponseField name="max_concurrency" type="integer">
  Maximum number of workers that can run this crawler in parallel. Example: `20`
</ResponseField>

<ResponseField name="credits_per_row" type="object">
  Credits charged per result row, keyed by plan type: `current` is the rate on today's plans, `legacy` the rate kept by grandfathered subscriptions. Example: `{"legacy": 1, "current": 1}`
</ResponseField>

<ResponseField name="credits_per_email" type="object">
  Credits charged per email found, keyed the same way as `credits_per_row`. Only meaningful for crawlers with an email enrichment function. Example: `{"legacy": 100, "current": 2}`
</ResponseField>

<ResponseField name="has_email_verification" type="boolean">
  Whether this crawler can verify the email addresses it finds. Example: `true`
</ResponseField>

<ResponseField name="default_worker_stats" type="object | null">
  Throughput profile of the crawler's default worker — `success_ratio`, `min_rate_per_worker`, and `max_rate_per_worker`. Used to project how long a run will take. `null` when no profile is published. Example: `{"success_ratio": 1, "max_rate_per_worker": 200, "min_rate_per_worker": 100}`
</ResponseField>

<ResponseField name="email_worker_stats" type="object | null">
  Same throughput profile for the email enrichment worker, which is typically slower and has a lower success ratio. `null` when the crawler has no email function. Example: `{"success_ratio": 0.3, "max_rate_per_worker": 30, "min_rate_per_worker": 20}`
</ResponseField>

<ResponseField name="chains" type="array">
  Crawlers this one can chain into — each entry describes the target crawler, how its fields map from this crawler's output (`field_map`), whether it autostarts by default, and the squid-level parameters it accepts. Empty when the crawler supports no chaining. See [Configure Chain](https://staging.docs.lobstr.io/examples/google-maps-leads-scraper/configure-chain) for a worked example.
</ResponseField>

## Understanding Input Parameters

<ResponseField name="input[].level" type="string">
  Parameter level: "task" (per URL/task) or "squid" (overall run behavior). Example: `""`
</ResponseField>

<ResponseField name="input[].is_params" type="string">
  For task-level: true indicates this parameter is used per task submission. Example: `""`
</ResponseField>

<ResponseField name="input[].is_details" type="string">
  For squid-level: true indicates this controls overall behavior or features. Example: `""`
</ResponseField>

<ResponseField name="input[].function" type="string">
  If true, this is an optional add-on feature with extra credit costs. Example: `""`
</ResponseField>

<ResponseField name="input[].credits_per_function" type="object">
  Extra credits per result when this function is on, keyed by plan type like `credits_per_row`: `current` is the rate on today's plans, `legacy` the rate kept by grandfathered subscriptions ([Get User Profile](https://staging.docs.lobstr.io/docs/user-me) → `plan[].is_legacy`). Example: `{"legacy": 80, "current": 4}`
</ResponseField>

<ResponseField name="input[].credits_per_filter" type="object">
  Credits per result checked when this filter is on, keyed the same way. Example: `{"legacy": 0.2, "current": 0.2}`
</ResponseField>

<ResponseField name="input[].name" type="string">
  Parameter name to use when configuring the crawler. Example: `"Google Maps (1)"`
</ResponseField>

<ResponseField name="input[].type" type="string">
  Data type of the parameter (string, int, boolean, etc.). Example: `""`
</ResponseField>

<ResponseField name="input[].required" type="string">
  Whether this parameter is mandatory. Example: `""`
</ResponseField>

<ResponseField name="input[].default" type="string">
  Default value if parameter is not provided. Example: `""`
</ResponseField>

<Tip>
  Check the 'has_issues' flag before creating tasks. If true, the crawler is experiencing problems and runs are paused.
</Tip>

<Note>
  Parameters with 'function: true' are optional add-ons that cost extra credits per result (specified in 'credits_per_function', keyed by plan type).
</Note>

<Warning>
  Some crawlers require account synchronization (see 'account' field). You'll need to sync cookies before running these crawlers.
</Warning>

<Tip>
  Use the 'result' array to know exactly what fields will be returned in your data. This helps you plan your data processing pipeline.
</Tip>

## Code Examples

<CodeGroup>
```bash cURL
curl -X GET "https://api.lobstr.io/v1/crawlers/4734d096159ef05210e0e1677e8be823" \
  -H "Authorization: Token YOUR_API_KEY"
```

```python Python
import requests

crawler_id = "4734d096159ef05210e0e1677e8be823"
url = f"https://api.lobstr.io/v1/crawlers/{crawler_id}"
headers = {
    "Authorization": "Token YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
crawler = response.json()

print(f"Crawler: {crawler['name']}")
print(f"Status: {'Available' if crawler['is_available'] else 'Unavailable'}")
print(f"Has Issues: {crawler['has_issues']}")

# credits_per_row is keyed by plan type — use "current" unless you're on a
# grandfathered plan, in which case use "legacy".
print(f"Credits per row: {crawler['credits_per_row']['current']}\n")

# Display task-level inputs
print("Task-level parameters:")
task_inputs = [i for i in crawler['input'] if i['level'] == 'task']
for param in task_inputs:
    req = "Required" if param['required'] else "Optional"
    print(f"  - {param['name']} ({param['type']}) - {req}")

# Display squid-level inputs with functions
print("\nSquid-level parameters:")
squid_inputs = [i for i in crawler['input'] if i['level'] == 'squid']
for param in squid_inputs:
    cost = f" (+{param['credits_per_function']['current']} credits)" if param.get('function') else ""
    print(f"  - {param['name']}{cost}")

# Display output fields
print(f"\nOutput fields ({len(crawler['result'])} total):")
print(", ".join(crawler['result'][:10]) + "...")
```
</CodeGroup>

## Response

```json 200
{
  "id": "4734d096159ef05210e0e1677e8be823",
  "object": "crawler",
  "account": null,
  "name": "Google Maps Leads Scraper",
  "slug": "google-maps-leads-scraper",
  "description": "Give us your properly built Google Maps Search URL(s). Grab all results available. Phone, rating, website included!",
  "help_article": null,
  "rank": 1,
  "icon": "PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI1MCIgaGVpZ2h0PSI1MCI+PC9zdmc+",
  "is_public": true,
  "is_available": true,
  "is_premium": false,
  "has_issues": false,
  "input": [
    {
      "name": "url",
      "type": "string",
      "level": "task",
      "regex": "http(.*)google(.*)/maps/(search|place)(.*)",
      "default": null,
      "example": "https://www.google.com/maps/search/restaurant/@43.2928346,5.3662584,14z",
      "required": false,
      "is_details": false,
      "description": "A string representing the Google Maps Search URL, containing all establishments the crawler will collect."
    },
    {
      "name": "activity",
      "type": "string",
      "level": "task",
      "value": "restaurant",
      "example": "restaurant",
      "required": false,
      "is_params": true,
      "description": "The activity of the search location."
    },
    {
      "max": 500,
      "name": "max_results",
      "type": "int",
      "level": "squid",
      "default": "",
      "example": 200,
      "required": false,
      "is_details": true,
      "description": "Maximum number of results retrieved *per task*. Leave empty to collect everything Google Maps returns for the search: up to about 330 places where the map is dense, fewer elsewhere."
    },
    {
      "name": "extract_emails_from_website",
      "type": "boolean",
      "level": "squid",
      "default": false,
      "display": "Extract Emails From Website",
      "function": true,
      "priority": 3,
      "required": false,
      "is_details": true,
      "description": "Extract email addresses from the business's website.",
      "credits_per_function": { "legacy": 10, "current": 1 }
    },
    {
      "name": "collect_business_details",
      "type": "boolean",
      "level": "squid",
      "default": false,
      "display": "Collect Business Details",
      "function": true,
      "priority": 1,
      "required": false,
      "is_details": true,
      "description": "Extract attributes like plus_code, poi, health, and last_opening_hours_updated_at.",
      "credits_per_function": { "legacy": 10, "current": 1 }
    }
  ],
  "result": [
    "zero_x",
    "cid",
    "url",
    "name",
    "address",
    "country_name",
    "country_code",
    "zip_code",
    "city",
    "lat",
    "lng",
    "ratings",
    "score",
    "category",
    "main_image_url",
    "phone",
    "website",
    "menu",
    "plus_code",
    "is_temporarily_closed",
    "is_permanently_closed",
    "has_owner",
    "opening_hours",
    "email",
    "facebook",
    "instagram"
  ],
  "max_concurrency": 20,
  "credits_per_row": {
    "legacy": 1,
    "current": 1
  },
  "credits_per_email": {
    "legacy": 100,
    "current": 2
  },
  "has_email_verification": true,
  "default_worker_stats": {
    "success_ratio": 1,
    "max_rate_per_worker": 200,
    "min_rate_per_worker": 100
  },
  "email_worker_stats": {
    "success_ratio": 0.3,
    "max_rate_per_worker": 30,
    "min_rate_per_worker": 20
  },
  "chains": [
    {
      "title": "Google Maps Reviews Scraper",
      "subtitle": "Collect all reviews from a GoogleMaps Etablishment URL!",
      "target": "googlemapreviews_matrix",
      "target_module_id": "e625ce52e98a6d4d1b53ef36dff7dacb",
      "field_map": { "url": "url" },
      "autostart_default": true
    }
  ]
}
```

<Note>
  The `input` and `result` arrays above are abridged. At the time of writing this
  crawler exposes 25 input parameters and 87 result fields — always read them
  from the live response rather than hard-coding them.
</Note>
