Stack Overflow hub

Stack Exchange Sites API

Every site in the network with the API name the other routes take, its audience and its related sites.

GET /v1/stack-overflow/sites

1 credit Failed requests are free

About this endpoint

GET /v1/stack-overflow/sites lists the Stack Exchange network. Each row has apiName, name, url, kind (main_site or meta_site), state, audience, aliases, relatedSites with relation, name, apiName and url, launchedAt, openBetaAt, closedBetaAt and markdownExtensions.

apiName is the value to pass as site on every other route, for example stackoverflow, askubuntu, math or ru.stackoverflow. The route has no site parameter of its own. Page with page.nextCursor while page.hasMore is true; the whole list fits in a few pages.

Stack Exchange Sites API FAQ

What do I do with apiName?

Pass it as site on any other Stack Overflow route. For example apiName math means site=math, and ru.stackoverflow is the Russian Stack Overflow.

How many credits does a sites page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

What are relatedSites?

Sites tied to the row: its meta site, its parent, or a chat site. relation says which, and apiName is filled when the related site is one of the sites in this list.

Does an alias work as site?

Aliases in the list are other addresses of the site. A host or URL is reduced to the API name, so the canonical url and the aliases both work as site.