Search Endpoint

GET /api/hf-projects/search

Search Endpoint

cURL

curl --request GET \
  --url https://api.example.com/api/hf-projects/search

200

{
  "projects": [
    {
      "author": "<string>",
      "entity_type": "model",
      "hf_id": "<string>",
      "name": "<string>",
      "url": "<string>",
      "created_at": "<string>",
      "description": "<string>",
      "downloads": 0,
      "library_name": "<string>",
      "likes": 0,
      "match_reasons": [],
      "matching_skills": [],
      "pipeline_tag": "<string>",
      "relevance_score": 0,
      "sdk": "<string>",
      "tags": []
    }
  ],
  "query": "<string>",
  "total": 0
}

Query Parameters

q · string · required

Minimum string length: 1

entity_type · enum<string> | null

Available options: model, dataset, space

sort · string · default: downloads

limit · integer · default: 30

Required range: 1 <= x <= 100

Response

200

application/json

Successful Response

Manual search results.

projects · HfProjectResult · object[] · required

Show child attributes

query · string · required

total · integer · default: 0