InsightSocial API
Hugging Face

Hugging Face Spaces API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/huggingface/spaces" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/huggingface/spaces

Search Hugging Face Spaces by keyword, SDK and tags.

Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Beta endpoints.

20 credits per call.

Paginates by cursor: see Pagination.

x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

query?string

Search text. Matches repository ids, tags and card text.

author?string

Only repositories owned by this user or organization.

sdk?string

Only Spaces built with this SDK.

Value in

  • "gradio"
  • "streamlit"
  • "docker"
  • "static"
tags?string

Comma-separated tags the repository must all have, e.g. text-classification,pytorch or license:mit.

sort?string

Sort order: downloads (last 30 days), likes, likes7d, likes30d, trending, created or updated. Default: trending.

Value in

  • "downloads"
  • "likes"
  • "likes7d"
  • "likes30d"
  • "trending"
  • "created"
  • "updated"
order?string

desc (default) or asc. asc only works with sort=created.

Value in

  • "asc"
  • "desc"
limit?integer

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

Range1 <= value <= 1000
cursor?string

Pass pagination.next_cursor from the previous response to get the next page. Keep the other parameters the same.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/huggingface/spaces"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "property1": null,    "property2": null  }}