Beschikbaarheid sociale handgreep API-referentie
Controleer of een gebruikersnaam beschikbaar is op grote sociale-mediaplatforms. Gebruik deze referentie om een bewerking te kiezen en het gedocumenteerde responsecontract te integreren.
Bewerkingen
GET /v1/social
GET
/v1/social
Queryparameters
| Parameter | Type | vereist |
|---|---|---|
| handle | string | vereist |
| platforms | string | optioneel |
| resources | string | optioneel |
Antwoordvelden
| Veld | Type |
|---|---|
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 |
Voorbeeldverzoek
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social?handle=myusername&platforms=github%2Cgitlab%2Cbitbucket%2Cdevto%2Chuggingface%2Cdribbble%2Csoundcloud%2Cgumroad%2Cbuymeacoffee%2Csubstack%2Citchio%2Chackernews%2Creddit%2Cbluesky%2Cpatreon%2Csnapchat%2Cyoutube&resources=github%3Arepository"Voorbeeldantwoord
{
"handle": "string",
"checked_at": "2026-04-15T12:00:00Z",
"availability": {},
"resources": {},
"resource_summary": {
"requested_count": 1,
"checked_count": 1,
"present_count": 1,
"absent_count": 1,
"unknown_count": 1,
"cached_count": 1,
"determinacy_rate": 1
},
"summary": {
"available_count": 1,
"unavailable_count": 1,
"unknown_count": 1
},
"summary_v2": {
"requested_count": 1,
"checked_count": 1,
"available_count": 1,
"unavailable_count": 1,
"unknown_count": 1,
"not_supported_count": 1,
"determinacy_rate": 1
},
"platform_summary": {
"requested_count": 1,
"checked_count": 1,
"available_count": 1,
"unavailable_count": 1,
"unknown_count": 1,
"not_supported_count": 1,
"cached_count": 1,
"high_confidence_count": 1,
"live_platform_count": 1,
"experimental_count": 1,
"blocked_count": 1,
"beta_limited_count": 1,
"determinacy_rate": 1,
"method_counts": {},
"source_counts": {}
},
"beta_notice": "string",
"meta": {
"supported_platforms": [
"string"
],
"supported_resources": [
"string"
],
"unsupported_platforms": [
"string"
],
"latency_ms": 1
}
}POST /v1/social/bulk
POST
/v1/social/bulk
Lichaamsparameters
| Parameter | Type | vereist |
|---|---|---|
| handles | string[] | vereist |
| platforms | string[] | optioneel |
| resources | string[] | optioneel |
Antwoordvelden
| Veld | Type |
|---|---|
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 |
Voorbeeldverzoek
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"
]
}'Voorbeeldantwoord
{
"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
GET
/v1/social/info
Antwoordvelden
| Veld | Type |
|---|---|
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 |
Voorbeeldverzoek
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social/info"Voorbeeldantwoord
{
"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
}
}
}