Hugging Face

Search Hugging Face papers

Search Hugging Face papers by keyword, or list the newest papers.

GET/v1/hugging-face/papers
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringquery

Search text. Without it the endpoint lists the newest papers. A search returns up to 120 papers and has no further pages.

min 1 chars · max 200 chars

limitintegerquery

Items per page, 1-100. A page can hold fewer. Default: 50.

≥ 1 · ≤ 100

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. Keep every other parameter the same.

min 1 chars · max 1024 chars

Response fields
35

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

Papers on this page.

datapapers[]id
string

arXiv id.

datapapers[]title
stringnullable

Paper title.

datapapers[]url
string

Paper page URL.

datapapers[]summary
stringnullable

Abstract.

datapapers[]publishedAt
stringnullable

When the paper was published (ISO-8601).

datapapers[]upvotes
integernullable

Upvotes.

datapapers[]numComments
integernullable

Comments on the paper page; null in paper search results.

datapapers[]thumbnailUrl
stringnullable

Thumbnail image URL.

datapapers[]githubRepo
stringnullable

Linked GitHub repository.

datapapers[]githubStars
integernullable

Stars on the linked GitHub repository; null in paper search results.

datapapers[]organization
stringnullable

Name of the organization the paper is listed under.

Who put the paper on the daily list; null in paper search results.

datapapers[]submittedByusername
string

Account name, the part of the profile URL after the domain.

datapapers[]submittedByuid
stringnullable

Stable account id.

datapapers[]submittedBydisplayName
stringnullable

Display name.

datapapers[]submittedByavatarUrl
stringnullable

Avatar image URL.

datapapers[]submittedByurl
string

Profile page URL.

datapapers[]submittedBytype
stringnullable

Whether the account is a user or an organization.

one of: user, org, null

datapapers[]submittedByisPro
booleannullable

Whether the account has a Pro subscription.

datapapers[]submittedByisStaff
booleannullable

Whether the account belongs to the platform's staff, when the response includes it.

datapapers[]submittedByfollowerCount
integernullable

Followers, when the response includes it.

datapapers[]submittedOnDailyAt
stringnullable

When the paper was added to the daily list (ISO-8601); null in paper search results.

datapapers[]aiSummary
stringnullable

Short summary generated by Hugging Face.

Keywords generated by Hugging Face.

datapapers[]aiKeywords[]
stringoptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; 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/hugging-face/papers?query=attention&limit=5" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Paper page.