Medium

List Medium daily entity URLs

List the user, publication, tag, list, topic, removed-post or removed-user URLs in one day's Medium sitemap.

GET/v1/medium/discover/{kind}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
kindstringrequiredpath

Kind of entity sitemap: `users`, `publications`, `tags`, `lists`, `catalogs`, `topics`, `removed-posts` or `removed-users`.

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

datestringrequiredquery

The day named by the sub-sitemap's file name (the index lists the available days).

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
26

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the day's file does not exist. A temporary failure returns an error, never `not_found`.

one of: found, not_found

datakind
string

Kind of entity sitemap: `users`, `publications`, `tags`, `lists`, `catalogs`, `topics`, `removed-posts` or `removed-users`.

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

datadate
string

UTC day from 1970 to 2100, `YYYY-MM-DD`, e.g. `2026-11-02`.

URLs in the sub-sitemap, in file order.

dataentries[]url
string

The absolute URL in the sitemap.

dataentries[]lastModified
stringnullable

`lastmod` as sent (a UTC date, or a date-time).

dataentries[]kind
string

Kind of sitemap file.

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

dataentries[]username
stringnullable

Handle, for a user, list or post entry.

dataentries[]slug
stringnullable

Publication slug, for a publication or post entry.

dataentries[]tag
stringnullable

Tag slug.

dataentries[]postId
stringnullable

Post id, for a post or removed-post entry.

dataentries[]listId
stringnullable

List id.

dataentries[]priority
numbernullableoptional

`priority` from the sitemap row, when it has one.

dataentries[]changefreq
stringnullableoptional

`changefreq` from the sitemap row, when it has one.

dataentries[]removed
booleannullable

True for the removed-posts and removed-users lists; null on lists of live entries.

Pagination state for a sitemap list.

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/discover/users?date=2024-01-15" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of the day's entity sitemap.