Get changefile for a date

Get details for a specific date’s changefile, including which entity types changed, how many records, and download links in JSONL and Parquet formats. For a full guide on using changefiles to keep your local data current, see Download Changefiles.

GET /changefiles/{date}

Get changefile for a date

cURL

curl --request GET \
  --url 'https://api.openalex.org/changefiles/{date}?api_key='

200

{
  "meta": {
    "count": 123,
    "date": "2023-12-25"
  },
  "results": [
    {
      "entity": "<string>",
      "records": 123,
      "formats": {
        "jsonl": {
          "size_bytes": 123,
          "size_display": "<string>",
          "url": "<string>"
        },
        "parquet": {
          "size_bytes": 123,
          "size_display": "<string>",
          "url": "<string>"
        }
      }
    }
  ]
}

Authorizations

api_key · string · query · required

Your OpenAlex API key. Get a free key at https://openalex.org/settings/api

Path Parameters

date · string<date> · required

The changefile date in YYYY-MM-DD format

Query Parameters

api_key · string · required

Your OpenAlex API key (required). Get a free key at https://openalex.org/settings/api

Response

200

application/json

Successful response

meta · object

Show child attributes

results · object[]

Show child attributes