---
title: "List Expat Living Italy's articles"
method: GET
path: "/articles"
---

# List Expat Living Italy's articles

`GET /articles`

## Request

- Base URL: `https://www.expatliving.it/api/v1`
- URL: `https://www.expatliving.it/api/v1/articles`
- Auth: none declared

Dated, sourced reporting on moving to and retiring in Italy, newest first. Filter by topic, place (a comune's ISTAT code) or dataset slug. Free to use provided you credit Expat Living Italy and link to the article: every response carries an `attribution` object with `required: true`. Answers 404 until the articles are live on expatliving.it.

## Query parameters

- `topic` string
- `place` string
- `dataset` string
- `include` 'archived'

## Response `200`

Matching articles.

- object
  - `articles` object[], required
    - `slug` string, required
    - `title` string, required
    - `deck` string, required
    - `author` string, required
    - `published` string, required
    - `updated` string, required
    - `status` 'published' | 'archived', required
    - `supersededBy` string: Slug of the newer article that replaces this one.
    - `topics` string[], required
    - `url` string, required
    - `markdownUrl` string, required: The whole article as Markdown, with its citation at both ends.
    - `places` object[], required
      - `grain` 'comune' | 'province' | 'region', required
      - `code` string, required: ISTAT code for a comune, sigla for a province, slug for a region.
      - `name` string, required
      - `url` string, required
    - `datasets` object[], required
      - `title` string, required
      - `url` string, required
      - `slug` string: The dataset's slug in GET /datasets, when the page is one of them.
      - `vintage` string
      - `coverage` string: How much of the place set the data covers, as the article states it.
  - `attribution` object, required
    - `required` true, required: Credit with a link is the condition of free use (CC BY 4.0).
    - `license` object, required
      - `name` string, required
      - `url` string, required
    - `creditText` string, required
    - `requirement` string, required
    - `citeAs` string, required: Per article: "“<title>” by <author>, Expat Living Italy, <date>. <url>".

## Other responses

- `404`: Articles aren't live yet.

---

[API](https://skmtc.dev/expatliving/apis/expat-living-italy-data-api.md) · [All operations](https://skmtc.dev/expatliving/apis/expat-living-italy-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/expatliving/apis/expat-living-italy-data-api/revisions/c72799dee52c?raw)