InsightSocial API
Hugging Face

Hugging Face Models 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/models" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/huggingface/models

Search and filter Hugging Face models by task, library, language, licence, base model and more.

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.

pipeline_tag?string

Task, e.g. text-generation or text-to-image. List them with the tags endpoint.

library?string

Library tag, e.g. transformers, diffusers or gguf.

language?string

Language code tag, e.g. en or ja.

license?string

Licence id, e.g. apache-2.0 or mit.

tags?string

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

base_model?string

Only models built from this base model. Use with relation.

relation?string

How the models relate to base_model: finetune, adapter, merge or quantized.

Value in

  • "finetune"
  • "adapter"
  • "merge"
  • "quantized"
gated?string

true for gated models only, false to hide them.

Value in

  • "true"
  • "false"
inference_provider?string

Only models a hosted inference provider serves: a provider id, or all for any provider.

min_parameters?string

Smallest parameter count, e.g. 500M or 7B.

max_parameters?string

Largest parameter count, e.g. 500M or 7B.

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/models"
{  "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  }}