# Getting started with Ruby

### Request

```ruby
require 'net/http'
require 'json'

API_KEY = "<REPLACE_WITH_YOUR_KEY>"
API_ENDPOINT = "https://api.craft.co/v1/query"
GRAPHQL_QUERY = "query getCompany($domain: String!) { company(domain: $domain) { locations { city, country } } }"

request_headers= { "Content-Type": "application/json", "x-craft-api-key": API_KEY }
request_data = {
    "query": GRAPHQL_QUERY,
    "variables": { "domain": "meta.com" }
}

response = Net::HTTP.post(URI(API_ENDPOINT), request_data.to_json, request_headers)
puts response.body
```

Make sure to replace `<REPLACE_WITH_YOUR_KEY>` with your unique API key.

### Response

The above command returns JSON structured like this:

```javascript
{
  "data": {
    "company": {
      "locations": [
        {
          "city": "Tokyo",
          "country": "JP"
        },
        {
          "city": "Ottawa",
          "country": "CA"
        },
        {
          "city": "Jakarta",
          "country": "ID"
        },
       ... 
      ]
    }
  }
}
```

#### **Read more**

* [Query basic company info](https://docs.craft.co/company-data-api/data-points/basic-company-information)
* [Query financials](https://docs.craft.co/company-data-api/data-points/financials)
* [Query operating data](https://docs.craft.co/company-data-api/data-points/operating-data)
* [Query human capital data](https://docs.craft.co/company-data-api/data-points/human-capital)