Quickstart¶

from scrapenest import ScrapeNestClient

    client = ScrapeNestClient(
        api_key="sn_live_...",
        base_url="https://api.scrapenest.com",
    )

    result = client.scrape_sync(
        job_type="light",
        target_url="https://example.com",
    )

    print(result.status)          # "succeeded"
    print(result.job_id)
    print(result.artifact_count)
    ```

=== "curl"
`bash
    curl -X POST "https://api.scrapenest.com/api/v1/jobs" \
      -H "X-API-Key: $SCRAPENEST_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "job_type": "light",
        "target_url": "https://example.com",
        "tags": ["env:prod", "type:catalog"]
      }'
    `

`scrape_sync` submits the job and blocks until it finishes (up to 120s). For long jobs or high throughput, use `scrape_async` and [webhooks](webhooks/overview.md) instead.

### Choosing a tier

=== "Light"
Fast HTTP engine with TLS impersonation — APIs, static pages, high-volume catalogs.

    ```python
    client.scrape_sync(job_type="light", target_url="https://example.com/api/products")
    ```

=== "Standard"
Full browser rendering for JavaScript-heavy apps and dashboards.

    ```python
    client.scrape_sync(
        job_type="standard",
        target_url="https://example.com/dashboard",
        wait_until="networkidle",
    )
    ```

=== "Stealth"
Hardened browser tier for targets with bot challenges, fingerprint checks, or unstable standard-browser success rates.

    ```python
    client.scrape_sync(
        job_type="stealth",
        target_url="https://protected.example.com",
        os_name="macos",
        browser_extensions=["ublock", "isdcac"],
    )
    ```

See [Worker Tiers](concepts/scraping.md) for a full comparison and [Job Parameters](reference/job-parameters.md) for every option.

## 4. Read the result

A finished job produces [artifacts](reference/artifacts.md) — rendered HTML, screenshots, extracted JSON, and metadata. List them on the job, then request a short-lived presigned URL for the bytes.

=== "Python"
```python
job = client.jobs.get(result.job_id)
for a in job.artifacts:
print(a.artifact_type, a.artifact_id)

    html_artifact = next(a for a in job.artifacts if a.artifact_type == "html")
    html = client.artifacts.download_text(html_artifact.artifact_id)
    ```

=== "curl"
```bash # Fetch the job (include_download_urls returns artifact URLs inline)
curl "https://api.scrapenest.com/api/v1/jobs/JOB_ID?include_download_urls=true" \
 -H "X-API-Key: $SCRAPENEST_API_KEY"

    # Download an artifact's bytes from its presigned URL
    curl -L "PRESIGNED_DOWNLOAD_URL" -o result.html
    ```

Artifacts are governed by your organization's [retention policy](concepts/data-retention.md). You can place [legal holds](concepts/data-retention.md#legal-holds) on critical data to prevent automated purging.

## Next steps

- **[Python SDK](sdk/python.md)** — the full client reference (sync vs async, options, artifacts).
- **[Guides](guides/extract-data.md)** — copy-paste recipes: extract data, screenshots, SPAs, anti-bot.
- **[Authentication](authentication.md)** — RBAC, scopes, and IP allowlisting.
- **[Webhooks](webhooks/overview.md)** — get notified instead of polling.