مرجع المطورين

توفر معرف الوسائط الاجتماعية

باستخدام DomScan API، تحقق مما إذا كان اسم المستخدم متاحًا عبر منصات الوسائط الاجتماعية الرئيسية.

توفر معرف الوسائط الاجتماعية

تحقق مما إذا كان اسم المستخدم متاحًا عبر منصات الوسائط الاجتماعية الرئيسية.

GET /v1/social

معاملات الاستعلام

المعامل	النوع	Description
handle مطلوب	string	اسم المستخدم/المعرّف للتحقق منه
platforms	string	قائمة المنصات المراد فحصها مفصولة بفواصل (الافتراضي: جميع المنصات المدعومة)
resources	string	أنواع موارد اختيارية مفصولة بفواصل. عند عدم تحديد المنصات، لا يتم فحص سوى هذه الموارد.

مثال الرد

{
                "handle": "mycompany",
                "availability": {
                "github": { "available": false, "profile_url": "https://github.com/mycompany", "checked": true, "requested": true, "method": "official_api", "confidence": "high" },
                "reddit": { "available": true, "profile_url": null, "checked": true, "requested": true, "method": "public_endpoint", "confidence": "high" },
                "youtube": { "available": true, "profile_url": null, "checked": true, "requested": true, "method": "public_profile", "confidence": "high" }
                },
                "resources": {},
                "resource_summary": {
                "requested_count": 0,
                "checked_count": 0,
                "present_count": 0,
                "absent_count": 0,
                "unknown_count": 0,
                "cached_count": 0,
                "determinacy_rate": 0
                },
                "summary": {
                "available_count": 2,
                "unavailable_count": 1,
                "unknown_count": 0
                },
                "summary_v2": {
                "requested_count": 3,
                "checked_count": 3,
                "available_count": 2,
                "unavailable_count": 1,
                "unknown_count": 0,
                "not_supported_count": 0,
                "determinacy_rate": 1
                }
                }

حقول الرد

الحقل	النوع
`handle`	string
`checked_at`	string
`availability`	object
`resources`	object
`resource_summary`	object
`resource_summary.requested_count`	integer
`resource_summary.checked_count`	integer
`resource_summary.present_count`	integer
`resource_summary.absent_count`	integer
`resource_summary.unknown_count`	integer
`resource_summary.cached_count`	integer
`resource_summary.determinacy_rate`	number
`summary`	object
`summary.available_count`	integer
`summary.unavailable_count`	integer
`summary.unknown_count`	integer
`summary_v2`	object
`summary_v2.requested_count`	integer
`summary_v2.checked_count`	integer
`summary_v2.available_count`	integer
`summary_v2.unavailable_count`	integer
`summary_v2.unknown_count`	integer
`summary_v2.not_supported_count`	integer
`summary_v2.determinacy_rate`	number
`platform_summary`	object
`platform_summary.requested_count`	integer
`platform_summary.checked_count`	integer
`platform_summary.available_count`	integer
`platform_summary.unavailable_count`	integer
`platform_summary.unknown_count`	integer
`platform_summary.not_supported_count`	integer
`platform_summary.cached_count`	integer
`platform_summary.high_confidence_count`	integer
`platform_summary.live_platform_count`	integer
`platform_summary.experimental_count`	integer
`platform_summary.blocked_count`	integer
`platform_summary.beta_limited_count`	integer
`platform_summary.determinacy_rate`	number
`platform_summary.method_counts`	object
`platform_summary.source_counts`	object
`beta_notice`	string
`meta`	object
`meta.supported_platforms[]`	string[]
`meta.supported_resources[]`	string[]
`meta.unsupported_platforms[]`	string[]
`meta.latency_ms`	integer

موارد المنصات

تحقق من هويات محددة النطاق، مثل المستودعات ومجتمعات Reddit ودعوات Discord وملفات Substack والحسابات الاتحادية، من دون تغيير نقاط النهاية.

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social?handle=github%2Fdocs&resources=github%3Arepository"

التحقق المجمع من معرّفات التواصل الاجتماعي

نعم. أرسل ما يصل إلى 10 معرّفات إلى POST /v1/social/bulk، مع قائمة منصات اختيارية. تستخدم عمليات التحقق المجمعة تكلفة الأرصدة نفسها لكل معرّف كما في عمليات التحقق الفردية.

curl -X POST "https://domscan.net/v1/social/bulk" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handles":["mycompany","myproduct"],"platforms":["github","reddit","youtube"]}'

POST /v1/social/bulk

معاملات الجسم

المعامل	النوع	مطلوب
handles	string[]	مطلوب
platforms	string[]	اختياري
resources	string[]	اختياري

حقول الرد

الحقل	النوع
`results[]`	unknown[]
`summary`	object
`summary.total`	integer
`summary.succeeded`	integer
`summary.failed`	integer
`beta_notice`	string
`meta`	object
`meta.served_by`	string
`meta.platforms[]`	string[]
`meta.resources[]`	string[]
`meta.max_handles`	integer
`meta.credits_per_handle`	integer
`meta.credits_required`	integer
`meta.latency_ms`	integer

طلب مثال

curl -X POST "https://domscan.net/v1/social/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "handles": [
    "mycompany",
    "myproduct"
  ],
  "platforms": [
    "github",
    "reddit",
    "youtube"
  ]
}'

مثال الرد

{
  "results": [
    {
      "handle": "mycompany",
      "availability": {
        "github": {
          "available": false,
          "profile_url": "https://github.com/mycompany",
          "checked": true,
          "requested": true,
          "method": "official_api",
          "confidence": "high"
        }
      },
      "resources": {},
      "resource_summary": {
        "requested_count": 0,
        "checked_count": 0,
        "present_count": 0,
        "absent_count": 0,
        "unknown_count": 0,
        "cached_count": 0,
        "determinacy_rate": 0
      },
      "summary": {
        "available_count": 0,
        "unavailable_count": 1,
        "unknown_count": 0
      },
      "checked_at": "2026-07-09T20:45:00.000Z"
    },
    {
      "handle": "myproduct",
      "availability": {
        "github": {
          "available": true,
          "profile_url": null,
          "checked": true,
          "requested": true,
          "method": "official_api",
          "confidence": "high"
        }
      },
      "resources": {},
      "resource_summary": {
        "requested_count": 0,
        "checked_count": 0,
        "present_count": 0,
        "absent_count": 0,
        "unknown_count": 0,
        "cached_count": 0,
        "determinacy_rate": 0
      },
      "summary": {
        "available_count": 1,
        "unavailable_count": 0,
        "unknown_count": 0
      },
      "checked_at": "2026-07-09T20:45:00.000Z"
    }
  ],
  "summary": {
    "total": 2,
    "succeeded": 2,
    "failed": 0
  },
  "beta_notice": "Social handle checks are in beta; verify critical results directly.",
  "meta": {
    "served_by": "pop=MAD country=ES",
    "platforms": [
      "github"
    ],
    "resources": [],
    "max_handles": 10,
    "credits_per_handle": 2,
    "credits_required": 4,
    "latency_ms": 420
  }
}

GET /v1/social/info

حقول الرد

الحقل	النوع
`endpoint`	string
`description`	string
`parameters`	object
`bulk`	object
`bulk.endpoint`	string
`bulk.method`	string
`bulk.max_handles`	integer
`bulk.credits_per_handle`	integer
`bulk.pricing_formula`	string
`bulk.bulk_discount`	boolean
`bulk.invalid_handles_charged`	boolean
`bulk.partial_results`	boolean
`bulk.parameters`	object
`bulk.example_request`	object
`platforms`	object
`platforms.supported[]`	string[]
`platforms.coming_soon[]`	string[]
`platforms.experimental[]`	string[]
`platforms.planned[]`	string[]
`platforms.blocked[]`	string[]
`platforms.details[]`	object[]
`platforms.details[]`	object
`platforms.details[].id`	string
`platforms.details[].display_name`	string
`platforms.details[].aliases[]`	string[]
`platforms.details[].category`	string
`platforms.details[].tier`	integer
`platforms.details[].status`	string
`platforms.details[].method`	string
`platforms.details[].confidence`	string
`platforms.details[].logo_key`	string
`platforms.details[].profile_url_template`	string \| null
`platforms.details[].docs_anchor`	string
`platforms.details[].caveat_codes[]`	string[]
`platforms.details[].cache_ttl_s`	object
`platforms.details[].cache_ttl_s.available`	integer
`platforms.details[].cache_ttl_s.taken`	integer
`platforms.details[].cache_ttl_s.unknown`	integer
`platforms.details[].cache_ttl_s.rate_limited`	integer
`platforms.details[].handle_rules`	object
`platforms.details[].handle_rules.min_length`	integer
`platforms.details[].handle_rules.max_length`	integer
`platforms.details[].handle_rules.description`	string
`resource_types`	object
`resource_types.supported[]`	string[]
`resource_types.details[]`	object[]
`resource_types.details[]`	object
`example_request`	string
`resource_example_request`	string
`example_response`	object

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social/info"

مثال الرد

{
  "endpoint": "/v1/social",
  "description": "Check if a username is available on supported social platforms.",
  "parameters": {
    "handle": {
      "type": "string",
      "required": true,
      "description": "Username to check"
    },
    "platforms": {
      "type": "string",
      "required": false,
      "description": "Comma-separated platform list",
      "example": "github,gitlab,reddit"
    },
    "resources": {
      "type": "string",
      "required": false,
      "description": "Comma-separated resource type list",
      "example": "github:repository"
    }
  },
  "bulk": {
    "endpoint": "/v1/social/bulk",
    "method": "POST",
    "max_handles": 10,
    "credits_per_handle": 2,
    "pricing_formula": "valid_handle_count * credits_per_handle",
    "bulk_discount": false,
    "invalid_handles_charged": false,
    "partial_results": true,
    "parameters": {
      "handles": {
        "type": "array",
        "required": true,
        "min_items": 1,
        "max_items": 10
      },
      "platforms": {
        "type": "array",
        "required": false
      },
      "resources": {
        "type": "array",
        "required": false
      }
    },
    "example_request": {
      "handles": [
        "mycompany",
        "myproduct"
      ],
      "platforms": [
        "github",
        "reddit",
        "youtube"
      ]
    }
  },
  "platforms": {
    "supported": [
      "github",
      "gitlab",
      "bitbucket",
      "devto",
      "huggingface",
      "dribbble",
      "soundcloud",
      "gumroad",
      "buymeacoffee",
      "substack",
      "itchio",
      "behance",
      "dockerhub",
      "hashnode",
      "rubygems",
      "hackernews",
      "reddit",
      "bluesky",
      "twitter",
      "instagram",
      "facebook",
      "threads",
      "pinterest",
      "snapchat",
      "telegram",
      "twitch",
      "patreon",
      "tiktok",
      "youtube",
      "linkedin",
      "steam",
      "tumblr",
      "vimeo",
      "letterboxd",
      "linktree"
    ],
    "coming_soon": [
      "discord"
    ],
    "experimental": [],
    "planned": [],
    "blocked": [
      "discord"
    ],
    "details": [
      {
        "id": "github",
        "display_name": "GitHub",
        "aliases": [
          "github"
        ],
        "category": "developer",
        "tier": 0,
        "status": "live",
        "method": "official_api",
        "confidence": "high",
        "logo_key": "github",
        "profile_url_template": "https://github.com/{handle}",
        "docs_anchor": "github",
        "caveat_codes": [],
        "cache_ttl_s": {
          "available": 300,
          "taken": 3600,
          "unknown": 60,
          "rate_limited": 60
        },
        "handle_rules": {
          "min_length": 1,
          "max_length": 39,
          "description": "1-39 chars, alphanumeric and hyphens, cannot start/end with hyphen"
        }
      }
    ]
  },
  "resource_types": {
    "supported": [
      "reddit:subreddit",
      "discord:invite",
      "github:repository",
      "gitlab:project",
      "dockerhub:repository",
      "activitypub:account",
      "substack:profile"
    ]
  },
  "example_request": "/v1/social?handle=myusername&platforms=github,gitlab,reddit",
  "resource_example_request": "/v1/social?handle=github/docs&resources=github:repository",
  "example_response": {
    "handle": "myusername",
    "checked_at": "2026-07-14T12:00:00Z",
    "availability": {
      "github": {
        "available": true,
        "profile_url": null,
        "checked": true,
        "requested": true
      },
      "reddit": {
        "available": false,
        "profile_url": "https://reddit.com/user/myusername",
        "checked": true,
        "requested": true
      },
      "gitlab": {
        "available": true,
        "profile_url": null,
        "checked": true,
        "requested": true
      }
    },
    "resources": {},
    "resource_summary": {
      "requested_count": 0,
      "checked_count": 0,
      "present_count": 0,
      "absent_count": 0,
      "unknown_count": 0,
      "cached_count": 0,
      "determinacy_rate": 0
    },
    "summary": {
      "available_count": 2,
      "unavailable_count": 1,
      "unknown_count": 0
    },
    "summary_v2": {
      "requested_count": 3,
      "checked_count": 3,
      "available_count": 2,
      "unavailable_count": 1,
      "unknown_count": 0,
      "not_supported_count": 0,
      "determinacy_rate": 1
    }
  }
}