Medium

List available Medium sitemap files

List one page of the available Medium sitemap files of one kind, with the newest real file.

GET/v1/medium/sitemap
2credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
kindstringrequiredquery

Only files of this kind. `posts` has one file per day from 2000 through the most recent day with a file.

one of: posts, users, publications, tags, lists, catalogs, topics, removed-posts, removed-users, staticpaths

limitintegeroptionalquery

Rows per page, 1 to 500. Default: 100.

≥ 1 · ≤ 500

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 2048 chars

Response fields
25

Endpoint-specific response payload.

datakind
string

Kind of sitemap file.

one of: posts, users, publications, tags, lists, catalogs, topics, removed-posts, removed-users, staticpaths

One page of this kind's files, in index order (not sorted by date).

datafiles[]url
string

Absolute URL of the sub-sitemap.

datafiles[]path
string

Path of the sub-sitemap on medium.com.

datafiles[]kind
string

Kind of sitemap file.

one of: posts, users, publications, tags, lists, catalogs, topics, removed-posts, removed-users, staticpaths

datafiles[]date
stringnullable

The date in the file name, `YYYY-MM-DD`, when it has one.

datafiles[]lastModified
stringnullable

`lastmod` as sent.

datacount
integer

Number of files of this kind.

≥ 0

The newest real file of this kind, when the index has one. Future-dated junk rows stay in `files[]` but are never `latest`.

datalatesturl
string

Absolute URL of the sub-sitemap.

datalatestpath
string

Path of the sub-sitemap on medium.com.

datalatestkind
string

Kind of sitemap file.

one of: posts, users, publications, tags, lists, catalogs, topics, removed-posts, removed-users, staticpaths

datalatestdate
stringnullable

The date in the file name, `YYYY-MM-DD`, when it has one.

datalatestlastModified
stringnullable

`lastmod` as sent.

Pagination over the files of this kind; `total` equals `count`.

datapagelimit
integer

Page size used for this answer.

≥ 0

datapagereturned
integer

Rows in this page.

≥ 0

datapagetotal
integer

Rows in the file for this page.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Opaque cursor for the next page; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/medium/sitemap?kind=posts" \
  -H "x-api-key: YOUR_API_KEY"

Responses

The available files of one sitemap kind.