# 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](https://docs.craft.co/alerts-api/alerts-api-queries)
* [Alerts API Reference](https://docs.craft.co/alerts-api/alerts-api-reference)
* [Query examples](https://docs.craft.co/alerts-api/query-examples)