# Social Fetch API - Wikipedia endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

26 documented Wikipedia operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/wikipedia/pages/{title}
Get Wikipedia page
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/get.mdx
SDK: client.wikipedia.getPage({ title: "Albert Einstein" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- include (optional, array) - Extra parts: `links` (search-index lists), `assessments` (WikiProject classes and importance) and `pageviews` (the last 60 days), comma-separated. Default: none.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages
Get several Wikipedia pages
Credit cost: 1 credit per title. Up to 20 titles per request. Max 20 credits. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/get.mdx
SDK: client.wikipedia.getPages({ titles: "Albert Einstein|Barack Obama" })
Parameters:
- titles (required, array) - Page titles separated by `|` (titles may contain commas), 1 to 20, e.g. `Albert Einstein|Barack Obama`. Duplicates are dropped.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
curl "https://api.socialfetch.dev/v1/wikipedia/pages?titles=Albert%20Einstein|Barack%20Obama" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/content
Get Wikipedia page content
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/content/get.mdx
SDK: client.wikipedia.getPageContent({ title: "Albert Einstein", format: "text" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- format (optional, string, enum: text | html | wikitext) - `text` for the plain-text lead (no lists or tables), `html` for the rendered article, `wikitext` for the source. Default: `text`.
- section (optional, integer) - HTML section number to return instead of the whole article.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/content?format=text" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/revisions
List Wikipedia page revisions
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/revisions/get.mdx
SDK: client.wikipedia.listPageRevisions({ title: "Albert Einstein", limit: 10 })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
- from (optional, string) - Start of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- to (optional, string) - End of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- dir (optional, string, enum: older | newer) - Direction from `from`: `older` (default) or `newer`. A reversed `from`/`to` window is swapped for the chosen direction.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/revisions?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/history-stats
Get Wikipedia page history statistics
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/history-stats/get.mdx
SDK: client.wikipedia.getPageHistoryStats({ title: "Albert Einstein" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/history-stats" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/backlinks
List Wikipedia page backlinks
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/backlinks/get.mdx
SDK: client.wikipedia.listPageBacklinks({ title: "Albert Einstein" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- namespace (optional, integer) - Namespace id, e.g. `0` for articles or `14` for categories.
- type (optional, string, enum: links | transclusions) - `links` for pages linking here, `transclusions` for pages transcluding it.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/backlinks" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/links
List Wikipedia page links
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/links/get.mdx
SDK: client.wikipedia.listPageLinks({ title: "Albert Einstein" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- type (optional, string, enum: internal | external | templates | categories | interwiki) - Which links: `internal`, `external` URLs, `templates`, `categories` or `interwiki`. Default: `internal`.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/links" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/languages
List Wikipedia page languages
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/languages/get.mdx
SDK: client.wikipedia.listPageLanguages({ title: "Albert Einstein" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/languages" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/media
List Wikipedia page media
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/media/get.mdx
SDK: client.wikipedia.listPageMedia({ title: "Albert Einstein" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/media" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pages/{title}/pageviews
Get Wikipedia page pageviews
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pages/title/pageviews/get.mdx
SDK: client.wikipedia.getPagePageviews({ title: "Albert Einstein" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- from (optional, string) - Start of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- to (optional, string) - End of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- granularity (optional, string, enum: daily | monthly) - `daily` (default) or `monthly`.
- access (optional, string, enum: all-access | desktop | mobile-app | mobile-web) - Access method. Default: `all-access`.
- agent (optional, string, enum: user | spider | automated | all-agents) - Agent class. Default: `user`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pages/Albert%20Einstein/pageviews" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pageviews/top
Get most-viewed Wikipedia pages
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pageviews/top/get.mdx
SDK: client.wikipedia.listPageviewsTop({ date: "2026-11-02" })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- mode (optional, string, enum: articles | countries) - `articles` for the most-viewed articles (the default), `countries` for the countries that viewed the edition most.
- date (optional, string) - Day (`YYYY-MM-DD`) for `mode=articles`, month (`YYYY-MM`) for `mode=countries`. Default: the latest published one, which is yesterday or last month (UTC), or the one before while that list is not out yet.
- access (optional, string, enum: all-access | desktop | mobile-app | mobile-web) - Access method. Default: `all-access`.
- country (optional, string) - Country code. With `mode=articles`, ranks that country's articles instead of the global list.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pageviews/top?date=2026-11-02" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/pageviews/site
Get Wikipedia site pageviews
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/pageviews/site/get.mdx
SDK: client.wikipedia.getSitePageviews({ lang: "en" })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- metric (optional, string, enum: views | unique_devices) - `views` (default) or `unique_devices`.
- from (optional, string) - Start of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- to (optional, string) - End of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- granularity (optional, string, enum: daily | monthly) - `daily` (default) or `monthly`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/pageviews/site?lang=en" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/search
Search Wikipedia
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/search/get.mdx
SDK: client.wikipedia.search({ query: "einstein" })
Parameters:
- query (required, string) - Search text. Operators such as `insource:`, `incategory:` and `intitle:` work. A plain `insource:/.../` regular expression can be slow; prefer words or `insource:"..."`. At most 300 characters.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- limit (optional, integer) - Results per page, 1 to 500. Default: 50.
- offset (optional, integer) - First result to return, 0 to 9999. Use `cursor` to continue a walk.
- sort (optional, string) - Result order: relevance (default), create_timestamp, incoming_links, last_edit, title_natural, just_match, none or random, optionally with `_asc` or `_desc`.
- namespace (optional, integer) - Namespace id, e.g. `0` for articles or `14` for categories.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters. Rankings can shift between pages, so a title can repeat at a page boundary; de-duplicate by `pageId`.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/search?query=einstein" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/search/suggest
Get Wikipedia title suggestions
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/search/suggest/get.mdx
SDK: client.wikipedia.suggestTitles({ query: "Albert" })
Parameters:
- query (required, string) - Title fragment to autocomplete.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- limit (optional, integer) - Suggestions per page, 1 to 100. Default: 10.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/search/suggest?query=Albert" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/categories/{title}/members
List Wikipedia category members
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/categories/title/members/get.mdx
SDK: client.wikipedia.listCategoryMembers({ title: "Category:Living people" })
Parameters:
- title (required, string) - Page title on the chosen edition, e.g. `Albert Einstein`, `C++` or `Talk:Barack Obama`. URL-encode it in the path.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- type (optional, string, enum: page | subcat | file) - Only members of this kind: `page`, `subcat` or `file`.
- sort (optional, string, enum: sortkey | timestamp) - Sort by `sortkey` (default) or by the time the member joined.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/categories/Category%3ALiving%20people/members" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/geosearch
List Wikipedia pages near a place
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/geosearch/get.mdx
SDK: client.wikipedia.listNearbyPages({ lat: 51.5074, lon: -0.1278 })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- lat (optional, number) - Latitude, -90 to 90. Must be paired with `lon`.
- lon (optional, number) - Longitude, -180 to 180. Must be paired with `lat`.
- title (optional, string) - Page whose coordinates to search around, instead of `lat`/`lon`.
- radius (optional, integer) - Radius in metres, 10 to 10,000. Default: 10,000.
- limit (optional, integer) - Results to return, 1 to 500. Default: 50. The answer is the nearest results up to this number; there is no continuation.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/geosearch?title=Eiffel%20Tower" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/feed
Get Wikipedia featured feed
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/feed/get.mdx
SDK: client.wikipedia.getFeed({ date: "2026-11-02" })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- date (optional, string) - Day, `YYYY-MM-DD`. Default: yesterday, UTC.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/feed?date=2026-11-02" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/on-this-day
Get Wikipedia on-this-day entries
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/on-this-day/get.mdx
SDK: client.wikipedia.listOnThisDay({ month: 11, day: 2 })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- month (required, integer) - Month, 1 to 12.
- day (required, integer) - Day of the month, 1 to 31.
- type (optional, string, enum: selected | births | deaths | events | holidays | all) - `selected`, `births`, `deaths`, `events`, `holidays` or `all` (default). Each type can be several MB, and `all` returns every type at once.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/on-this-day?month=11&day=2" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/recent-changes
List Wikipedia recent changes
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/recent-changes/get.mdx
SDK: client.wikipedia.listRecentChanges({ lang: "en" })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- type (optional, string, enum: edit | new | log | categorize | external) - Only changes of this type.
- namespace (optional, integer) - Namespace id, e.g. `0` for articles or `14` for categories.
- since (optional, string) - Only changes at or after this time, as `YYYY-MM-DD` or an ISO 8601 date-time with a zone.
- title (optional, string) - Only changes to this page.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/recent-changes?lang=en" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/logs
List Wikipedia logs
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/logs/get.mdx
SDK: client.wikipedia.listLogs({ type: "delete" })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- type (optional, string, enum: delete | move | block | protect | newusers | upload | patrol | review | rights | create | merge | thanks | abusefilter) - Only events of this log type.
- title (optional, string) - Only events about this page.
- since (optional, string) - Only events at or after this time, as `YYYY-MM-DD` or an ISO 8601 date-time with a zone.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/logs?type=delete" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/users/{name}
Get Wikipedia user
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/users/name/get.mdx
SDK: client.wikipedia.getUser({ name: "Jimbo Wales" })
Parameters:
- name (required, string) - User name on the edition, e.g. `Jimbo Wales` or `ClueBot NG`. A profile URL is not accepted. An IP address has no user record; use the contributions route for its edits.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/users/Jimbo%20Wales" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/users/{name}/contributions
List Wikipedia user contributions
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/users/name/contributions/get.mdx
SDK: client.wikipedia.listUserContributions({ name: "Jimbo Wales" })
Parameters:
- name (required, string) - User name on the edition, e.g. `Jimbo Wales` or `ClueBot NG`. A profile URL is not accepted. An IP address has no user record; use the contributions route for its edits.
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- namespace (optional, integer) - Namespace id, e.g. `0` for articles or `14` for categories.
- from (optional, string) - Start of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- to (optional, string) - End of the window as a real `YYYY-MM-DD` day (read as midnight UTC) or a full ISO 8601 date-time with a zone.
- limit (optional, integer) - Rows per page, 1 to 500. Default: 50.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/users/Jimbo%20Wales/contributions" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/wikidata/entities/{id}
Get Wikidata entity
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/wikidata/entities/id/get.mdx
SDK: client.wikipedia.getWikidataEntity({ id: "Q937" })
Parameters:
- id (required, string) - Wikidata entity id (`Q937`, `P31`, `L1`, `M925243`), or a page title when `site` is given; `props` is then required.
- site (optional, string) - Wikimedia site id (`enwiki`, `dewiki`, `commonswiki`). When set, `id` is a page title on that site and the entity it links to is returned; `props` is required.
- languages (optional, array) - Languages to return labels, descriptions and aliases in, comma-separated, e.g. `en,de`. Default: every language.
- props (optional, array) - Entity parts to return, comma- or pipe-separated: `info`, `sitelinks`, `labels`, `descriptions`, `aliases`, `claims`. Required with `site`. Default: all six; without `site` or `languages`, the full entity.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/wikidata/entities/Q937" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/wikidata/search
Search Wikidata
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/wikidata/search/get.mdx
SDK: client.wikipedia.searchWikidata({ query: "einstein" })
Parameters:
- query (required, string) - Text to search for.
- lang (optional, string) - Edition code for labels, aliases and descriptions. Default: `en`.
- type (optional, string) - Entity type to search: `item` (default), `property`, `lexeme`, `form` or `sense`.
- limit (optional, integer) - Results per page, 1 to 50. Default: 50. The walk stops at 100 results in total.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/wikidata/search?query=einstein" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/wikidata/query
Get Wikidata SPARQL query result
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/wikidata/query/get.mdx
SDK: client.wikipedia.runWikidataQuery({ sparql: "SELECT ?item WHERE { ?item wdt:P31 wd:Q146 } LIMIT 3" })
Parameters:
- sparql (required, string) - Read-only SPARQL query. `INSERT`, `DELETE`, `LOAD`, `CLEAR`, `DROP`, `CREATE`, `ADD`, `MOVE`, `COPY` and `WITH` are refused.
- format (optional, string, enum: json) - Result format. Only `json` is served.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/wikidata/query?sparql=SELECT%20?item%20WHERE%20{%20?item%20wdt:P31%20wd:Q146%20}%20LIMIT%203" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/wikipedia/random
List random Wikipedia pages
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/wikipedia/random/get.mdx
SDK: client.wikipedia.listRandomPages({ limit: 5 })
Parameters:
- lang (optional, string) - Wikimedia edition code, e.g. `en`, `de`, `ja`, `simple` or `zh-min-nan`. Default: `en`.
- namespace (optional, integer) - Namespace id, e.g. `0` for articles or `14` for categories.
- limit (optional, integer) - Pages to return, 1 to 500. Default: 10.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/wikipedia/random?limit=5" \
  -H "x-api-key: YOUR_API_KEY"