> For the complete documentation index, see [llms.txt](https://docs.craft.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.craft.co/alerts-api/getting-started/getting-started-with-curl.md).

# Getting started with cURL

### Request code

To query the API, you can use any HTTP client of choice or any specialized GraphQL API Clients.

{% hint style="info" %}
Make sure to replace `<REPLACE_WITH_YOUR_KEY>` with your unique API key.
{% endhint %}

```bash
curl --request POST \
  --url 'https://api.craft.co/v1/query?=' \
  --header 'content-type: application/json' \
  --header 'x-craft-api-key: <REPLACE_WITH_YOUR_KEY>' \
  --data '{"query":"query getAlerts($first: Int!) { alerts(first: $first) { id dataset variable } }","variables":{"first":3},"operationName":"getAlerts"}'
```

### Response

The above command returns JSON structured like this:

```javascript
{
  "data": {
    "alerts": [
      {
        "id": "8da58037-d0b9-8365-75b4-6754aed4e9b0",
        "dataset": "news",
        "variable": "news_article"
      },
      {
        "id": "8489a57b-7be9-0364-a95d-65ad84ed430a",
        "dataset": "news",
        "variable": "news_article"
      },
      {
        "id": "8489a57b-7be9-0364-a90d-65ad84ed430a",
        "dataset": "news",
        "variable": "news_article"
      },
      ...
    ]
  }
}
```

#### Read more

* [Querying Alerts API](/alerts-api/alerts-api-queries.md)
* [Alerts API Reference](/alerts-api/alerts-api-reference.md)
* [Query examples](/alerts-api/query-examples.md)