Getting Started

The Gluecrawl API lets you automate scraping workflows — create jobs, trigger runs, and retrieve data programmatically.

Base URL: https://api.gluecrawl.ai/v1/

Authentication

All /v1/ endpoints require an API key passed as a Bearer token.

1. Log in to your Gluecrawl dashboard
2. Click your avatar → API Key → Generate API Key
3. Copy your key — it is shown only once

Include the key in every request:

Authorization: Bearer glue_yourApiKeyHere

Example

curl https://api.gluecrawl.ai/v1/jobs \  -H "Authorization: Bearer glue_yourApiKeyHere"

Polling Workflow

The API is polling-based. The typical workflow for scraping a site:

1. Create a Job — status: in_progress
2. Get a Job until status is ready or failed
3. Create a Run — status: queued
4. Get a Run until status is completed or failed
5. Get Items or CSV export