Site APIs
Get a site API
One website’s endpoints, with their inputs, output fields, and health, and the defaults new skills there start with.
GET
/
v1
/
apis
/
{domain}
curl https://api.valendata.com/v1/apis/linkedin.com \
-H "Authorization: Bearer $VALENDATA_API_KEY"
{
"domain": "linkedin.com",
"defaults": {
"profile_id": "prof_7a2c9e41",
"login_id": null,
"browser_type": "remote",
"proxy_config": "us"
},
"endpoints": [
{
"name": "search_companies",
"skill_id": "sk_5d1e8b3a9c20",
"slug": "linkedin-company-search",
"title": "LinkedIn company search",
"description": "Search LinkedIn for companies by keyword and list them.",
"inputs": [
{ "name": "keyword", "type": "string", "required": true }
],
"fields": [
{ "name": "company_name", "type": "string" },
{ "name": "industry", "type": "string" },
{ "name": "followers", "type": "string" }
],
"health_status": "healthy",
"success_rate": 95.0,
"last_run_at": "2026-10-16T09:12:44Z",
"visibility": "private"
}
]
}
{
"detail": "You have no skill on linkedin.com.",
"code": "not_found",
"type": "invalid_request_error",
"request_id": "3f9a1c2b7d4e"
}
Needs
skills:read. Returns 404 when you have no skill on that site.
string
required
Bearer vd_sk_.... See Authentication.string
required
The site, as List your site APIs gives it, such as
linkedin.com.string
The site.
object
What a new skill on this site starts with. Existing skills keep their own settings. See Set a site’s defaults.
Show properties
Show properties
string | null
The browser profile.
string | null
The saved login.
string | null
The browser mode. Values are in Run settings.
string | null
The proxy region. Values are in Run settings.
object[]
One per skill on this site.
Show properties
Show properties
string
string
The skill’s id. Use it in Rename an endpoint.
string
The skill’s slug, for every
/v1/skills/{slug} route.string
The skill’s name.
string | null
What the skill does.
object[]
The inputs to send. For the full contract, call Get a skill.
object[]
The output fields every row has.
string
How the skill is doing right now. See Get a skill’s health.
number | null
Percent (0–100) of its last 20 counted runs that worked. Runs that failed on our side or were cancelled are not counted.
null before any counted run.string | null
When it last ran.
curl https://api.valendata.com/v1/apis/linkedin.com \
-H "Authorization: Bearer $VALENDATA_API_KEY"
{
"domain": "linkedin.com",
"defaults": {
"profile_id": "prof_7a2c9e41",
"login_id": null,
"browser_type": "remote",
"proxy_config": "us"
},
"endpoints": [
{
"name": "search_companies",
"skill_id": "sk_5d1e8b3a9c20",
"slug": "linkedin-company-search",
"title": "LinkedIn company search",
"description": "Search LinkedIn for companies by keyword and list them.",
"inputs": [
{ "name": "keyword", "type": "string", "required": true }
],
"fields": [
{ "name": "company_name", "type": "string" },
{ "name": "industry", "type": "string" },
{ "name": "followers", "type": "string" }
],
"health_status": "healthy",
"success_rate": 95.0,
"last_run_at": "2026-10-16T09:12:44Z",
"visibility": "private"
}
]
}
{
"detail": "You have no skill on linkedin.com.",
"code": "not_found",
"type": "invalid_request_error",
"request_id": "3f9a1c2b7d4e"
}
⌘I
curl https://api.valendata.com/v1/apis/linkedin.com \
-H "Authorization: Bearer $VALENDATA_API_KEY"
{
"domain": "linkedin.com",
"defaults": {
"profile_id": "prof_7a2c9e41",
"login_id": null,
"browser_type": "remote",
"proxy_config": "us"
},
"endpoints": [
{
"name": "search_companies",
"skill_id": "sk_5d1e8b3a9c20",
"slug": "linkedin-company-search",
"title": "LinkedIn company search",
"description": "Search LinkedIn for companies by keyword and list them.",
"inputs": [
{ "name": "keyword", "type": "string", "required": true }
],
"fields": [
{ "name": "company_name", "type": "string" },
{ "name": "industry", "type": "string" },
{ "name": "followers", "type": "string" }
],
"health_status": "healthy",
"success_rate": 95.0,
"last_run_at": "2026-10-16T09:12:44Z",
"visibility": "private"
}
]
}
{
"detail": "You have no skill on linkedin.com.",
"code": "not_found",
"type": "invalid_request_error",
"request_id": "3f9a1c2b7d4e"
}