> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nordicfinancialnews.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Get your API key and make your first request to the Nordic Financial News API.

<Steps>
  <Step title="Create an account and generate an API key">
    [Sign up](https://nordicfinancialnews.com/users/sign_up) for a Nordic Financial News account, then navigate to **Settings > API Keys** to generate your key.

    All plans include API access. Check your plan's limits in [API key settings](https://nordicfinancialnews.com/settings/api_keys).
  </Step>

  <Step title="Make your first request">
    <CodeGroup>
      ```bash cURL theme={"dark"}
      curl -H "Authorization: Bearer YOUR_API_KEY" \
        "https://nordicfinancialnews.com/api/v1/articles?limit=5"
      ```

      ```python Python theme={"dark"}
      import requests

      resp = requests.get(
          "https://nordicfinancialnews.com/api/v1/articles",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
          params={"limit": 5},
      )
      data = resp.json()
      print(data["articles"][0]["title"])
      ```

      ```ruby Ruby theme={"dark"}
      require "net/http"
      require "json"

      uri = URI("https://nordicfinancialnews.com/api/v1/articles?limit=5")
      req = Net::HTTP::Get.new(uri)
      req["Authorization"] = "Bearer YOUR_API_KEY"

      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
        http.request(req)
      end

      data = JSON.parse(res.body)
      puts data["articles"].first["title"]
      ```

      ```javascript JavaScript theme={"dark"}
      const resp = await fetch(
        "https://nordicfinancialnews.com/api/v1/articles?limit=5",
        {
          headers: { Authorization: "Bearer YOUR_API_KEY" },
        }
      );
      const data = await resp.json();
      console.log(data.articles[0].title);
      ```
    </CodeGroup>
  </Step>

  <Step title="Explore the response">
    Every list endpoint returns a resource array (e.g. `articles`, `stories`) along with pagination cursors. Use the `cursor` parameter to page through additional results.

    ```json Example response theme={"dark"}
    {
      "articles": [
        {
          "id": "art_abc123def",
          "title": "Volvo reports record profit",
          "article_url": "https://di.se/articles/volvo-q3-2026",
          "content_type": "news",
          "published_at": "2026-03-15T09:30:00Z",
          "category": { "id": "cat_earnings1", "name": "Earnings & Financial Results" },
          "source": { "name": "Dagens Industri", "domain": "di.se" },
          "company_ids": ["comp_volvo123"],
          "country": "SE"
        }
      ],
      "pagination": {
        "count": 5,
        "next_cursor": "eyJpZCI6..."
      }
    }
    ```
  </Step>
</Steps>

## Next steps

<Columns cols={2}>
  <Card title="Authentication" icon="key" color="#01B2FF" href="/guides/authentication" horizontal>
    Learn about API keys, scopes, and rate limits.
  </Card>

  <Card title="API reference" icon="square-terminal" color="#01B2FF" href="/api-reference/introduction" horizontal>
    Browse all endpoints with interactive examples.
  </Card>
</Columns>

## Disclaimer

<div style={{fontSize: '0.875rem', opacity: 0.7}}>
  <p>This API provides AI-processed, aggregated financial news and data for informational purposes only, not financial advice.</p>
  <p>Data is sourced from third parties and may be translated, summarised, or otherwise processed using automated systems. It may contain errors, inaccuracies, omissions, or lack full context.</p>
  <p>You are responsible for validating any data before relying on it and for how this data is used in your applications, including compliance with any applicable laws or regulations. Do not use this API as the sole basis for investment or financial decisions.</p>
  <p>Nordic Financial News does not guarantee the accuracy, completeness, or timeliness of the data and is not responsible for any loss or damage resulting from its use.</p>
</div>