Skip to main content
GET
/
sdgs
List SDGs
curl --request GET \
  --url 'https://api.openalex.org/sdgs?api_key='
{
  "meta": {
    "count": 123,
    "db_response_time_ms": 123,
    "page": 123,
    "per_page": 123,
    "next_cursor": "<string>",
    "groups_count": 123,
    "cost_usd": 123
  },
  "results": [
    {
      "id": "https://openalex.org/sdgs/3",
      "display_name": "<string>",
      "description": "<string>",
      "ids": {
        "openalex": "<string>",
        "un": "<string>",
        "wikidata": "<string>"
      },
      "works_count": 123,
      "cited_by_count": 123,
      "image_url": "<string>",
      "image_thumbnail_url": "<string>",
      "works_api_url": "<string>",
      "created_date": "2023-12-25",
      "updated_date": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
api_key
string
query
required

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

Query Parameters

​
filter
string

Filter SDGs. Examples: id:3 (Good Health), works_count:>100000 See all SDG fields.

​
sort
string

Sort by: works_count, cited_by_count. Prefix with - for descending. See all SDG fields.

​
search
string

Full-text search across titles, abstracts, and other text fields. Example: search=machine learning

​
per_page
integer
default:25

Number of results per page (1-100, default 25)

Required range: 1 <= x <= 100
​
page
integer

Page number for pagination. Use cursor for deep pagination beyond 10,000 results.

Required range: x >= 1
​
cursor
string

Cursor for deep pagination. Use cursor=* to start, then use the next_cursor from the response.

​
sample
integer

Return a random sample of N results (max 10,000). Cannot be used with sort or page.

Required range: x <= 10000
​
select
string

Comma-separated list of fields to return. Reduces response size. Example: select=id,display_name,cited_by_count

​
group_by
string

Group results by a field and return counts. Available fields vary by entity type. See all SDG fields.

​
api_key
string
required

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

Response

Successful response

​
meta
object

Metadata about the query results

​
results
object[]