Server definition
- Hash
- sha256:6610e727eb921b1095572e0766a331430c91cf1479e143b4f03825e9077a863a
- What it is
- What a remote MCP server returned when asked what it offers: 28 tools
The blob, as servednamed by its sha256
{
"instructions": "Gateway to the Serpzilla API for purchasing SEO link placements (permanent guest posts and monthly rentals). All actions are performed on behalf of the authenticated Serpzilla account.",
"tools": [
{
"description": "Create a new Serpzilla Guest Post article (Advertiser's Article) for a project. Returns articleId and urlId needed for purchase.",
"inputSchema": {
"$defs": {
"AddArticleArgs": {
"properties": {
"body": {
"description": "Article HTML text, must contain at least one link",
"maxLength": 64000,
"title": "Body",
"type": "string"
},
"is_comments_disabled": {
"default": false,
"description": "Disable comments",
"title": "Is Comments Disabled",
"type": "boolean"
},
"limit_max_usages": {
"default": 1,
"description": "Maximum usage limit",
"title": "Limit Max Usages",
"type": "integer"
},
"meta_description": {
"default": "",
"description": "META Description",
"title": "Meta Description",
"type": "string"
},
"meta_keywords": {
"default": "",
"description": "META Keywords",
"title": "Meta Keywords",
"type": "string"
},
"meta_title": {
"description": "META Title of the article",
"title": "Meta Title",
"type": "string"
},
"project_id": {
"description": "Project ID",
"title": "Project Id",
"type": "integer"
},
"title": {
"description": "Article title",
"minLength": 2,
"title": "Title",
"type": "string"
},
"url": {
"description": "Promoted URL (e.g., https://example.com)",
"title": "Url",
"type": "string"
}
},
"required": [
"project_id",
"url",
"title",
"body",
"meta_title"
],
"title": "AddArticleArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/AddArticleArgs"
}
},
"required": [
"args"
],
"title": "add_articleArguments",
"type": "object"
},
"name": "add_article",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "add_articleOutput",
"type": "object"
}
},
{
"description": "Add promoted URLs with anchor texts to a Serpzilla project. Each URL can have multiple anchor texts. Use #a#...#/a# markup within each text to specify the link portion. Used for purchasing placements where the webmaster (copywriter) writes the content. Returns urlId and textId needed for purchase.",
"inputSchema": {
"$defs": {
"AddTextsArgs": {
"properties": {
"project_id": {
"description": "Project ID",
"title": "Project Id",
"type": "integer"
},
"urls_texts": {
"description": "List of URLs with their anchor texts",
"items": {
"$ref": "#/$defs/UrlWithTexts"
},
"title": "Urls Texts",
"type": "array"
}
},
"required": [
"project_id",
"urls_texts"
],
"title": "AddTextsArgs",
"type": "object"
},
"AnchorText": {
"properties": {
"text": {
"description": "Anchor text. Use #a#...#/a# markup to mark the link portion.",
"maxLength": 100,
"minLength": 1,
"title": "Text",
"type": "string"
}
},
"required": [
"text"
],
"title": "AnchorText",
"type": "object"
},
"UrlWithTexts": {
"properties": {
"keywords": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional key phrases (max 255 chars each)",
"title": "Keywords"
},
"texts": {
"description": "Anchor texts for this URL",
"items": {
"$ref": "#/$defs/AnchorText"
},
"title": "Texts",
"type": "array"
},
"url": {
"description": "Promoted URL (e.g., https://example.com/blog/)",
"maxLength": 1500,
"minLength": 1,
"title": "Url",
"type": "string"
}
},
"required": [
"url",
"texts"
],
"title": "UrlWithTexts",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/AddTextsArgs"
}
},
"required": [
"args"
],
"title": "add_textsArguments",
"type": "object"
},
"name": "add_texts",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "add_textsOutput",
"type": "object"
}
},
{
"description": "Add domains to the Serpzilla Blacklist by domain IDs and/or domain names. Optionally scope the addition to project blacklists via project_ids. Returns a per-domain result (domainId, isError, errorMessage).",
"inputSchema": {
"$defs": {
"BlacklistAddDomainsArgs": {
"properties": {
"domains_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain IDs to add",
"title": "Domains Ids"
},
"domains_names": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain names to add (without scheme and www)",
"title": "Domains Names"
},
"project_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"maxItems": 50,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Project IDs whose blacklists the domains are added to (max 50). If omitted, the domains are added to the global blacklist only.",
"title": "Project Ids"
}
},
"title": "BlacklistAddDomainsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/BlacklistAddDomainsArgs"
}
},
"required": [
"args"
],
"title": "blacklist_add_domainsArguments",
"type": "object"
},
"name": "blacklist_add_domains",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "blacklist_add_domainsOutput",
"type": "object"
}
},
{
"description": "Remove domains from the Serpzilla Blacklist. Domains are identified by domain IDs only (from blacklist_get sections[].domainsList[].domainId). Optionally limit removal to specific project blacklists via project_ids.",
"inputSchema": {
"$defs": {
"BlacklistDeleteDomainsArgs": {
"properties": {
"domain_ids": {
"description": "Domain IDs to remove from the blacklist (from blacklist_get: sections[].domainsList[].domainId)",
"items": {
"type": "integer"
},
"minItems": 1,
"title": "Domain Ids",
"type": "array"
},
"project_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"maxItems": 50,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Project IDs whose blacklists the domains are removed from (max 50). If omitted, the domains are removed from the global blacklist.",
"title": "Project Ids"
}
},
"required": [
"domain_ids"
],
"title": "BlacklistDeleteDomainsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/BlacklistDeleteDomainsArgs"
}
},
"required": [
"args"
],
"title": "blacklist_delete_domainsArguments",
"type": "object"
},
"name": "blacklist_delete_domains",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "blacklist_delete_domainsOutput",
"type": "object"
}
},
{
"description": "Get domains from the Serpzilla Blacklist, grouped into sections. Returns the global Blacklist by default, or a project's own Blacklist when project_id is given. Supports pagination and sorting.",
"inputSchema": {
"$defs": {
"BlacklistGetArgs": {
"properties": {
"limit": {
"anyOf": [
{
"enum": [
250,
500,
1000,
5000
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domains per page (250/500/1000/5000)",
"title": "Limit"
},
"order_type": {
"anyOf": [
{
"enum": [
"byAlphabet",
"byCreatedAt"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort type: byAlphabet or byCreatedAt (default byCreatedAt)",
"title": "Order Type"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": 1,
"description": "Page number (starts at 1)",
"title": "Page"
},
"project_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Project ID. If provided, returns the project's blacklist; otherwise the global blacklist.",
"title": "Project Id"
}
},
"title": "BlacklistGetArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/BlacklistGetArgs"
}
},
"required": [
"args"
],
"title": "blacklist_getArguments",
"type": "object"
},
"name": "blacklist_get",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "blacklist_getOutput",
"type": "object"
}
},
{
"description": "Create a new Serpzilla project for domain promotion.",
"inputSchema": {
"$defs": {
"CreateProjectArgs": {
"properties": {
"domain": {
"description": "Domain to promote (e.g., https://example.com/)",
"maxLength": 100,
"title": "Domain",
"type": "string"
},
"name": {
"anyOf": [
{
"maxLength": 150,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Project name",
"title": "Name"
}
},
"required": [
"domain"
],
"title": "CreateProjectArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/CreateProjectArgs"
}
},
"required": [
"args"
],
"title": "create_projectArguments",
"type": "object"
},
"name": "create_project",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "create_projectOutput",
"type": "object"
}
},
{
"description": "Add domains to Serpzilla favorites lists. Domains can be identified by domain IDs, site IDs (from search results), or domain names. At least one identifier kind must be provided.",
"inputSchema": {
"$defs": {
"FavoritesAddDomainsArgs": {
"properties": {
"domains_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain IDs to add",
"title": "Domains Ids"
},
"domains_names": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain names to add (without scheme and www)",
"title": "Domains Names"
},
"lists_ids": {
"description": "Favorites list IDs to add the domains to",
"items": {
"type": "integer"
},
"title": "Lists Ids",
"type": "array"
},
"sites_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Site IDs to add",
"title": "Sites Ids"
}
},
"required": [
"lists_ids"
],
"title": "FavoritesAddDomainsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/FavoritesAddDomainsArgs"
}
},
"required": [
"args"
],
"title": "favorites_add_domainsArguments",
"type": "object"
},
"name": "favorites_add_domains",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_add_domainsOutput",
"type": "object"
}
},
{
"description": "Create a new Serpzilla favorites list (a named group of donor domains). Returns the created list ID.",
"inputSchema": {
"$defs": {
"FavoritesAddListArgs": {
"properties": {
"name": {
"description": "Favorites list title",
"minLength": 1,
"title": "Name",
"type": "string"
}
},
"required": [
"name"
],
"title": "FavoritesAddListArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/FavoritesAddListArgs"
}
},
"required": [
"args"
],
"title": "favorites_add_listArguments",
"type": "object"
},
"name": "favorites_add_list",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_add_listOutput",
"type": "object"
}
},
{
"description": "Remove domains from Serpzilla favorites lists. If list_ids is omitted, the domains are removed from ALL favorites lists.",
"inputSchema": {
"$defs": {
"FavoritesDeleteDomainsArgs": {
"properties": {
"domain_ids": {
"description": "Domain IDs to remove from favorites",
"items": {
"type": "integer"
},
"minItems": 1,
"title": "Domain Ids",
"type": "array"
},
"list_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "List IDs to remove the domains from. If omitted (null), the domains are removed from ALL favorites lists.",
"title": "List Ids"
}
},
"required": [
"domain_ids"
],
"title": "FavoritesDeleteDomainsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/FavoritesDeleteDomainsArgs"
}
},
"required": [
"args"
],
"title": "favorites_delete_domainsArguments",
"type": "object"
},
"name": "favorites_delete_domains",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_delete_domainsOutput",
"type": "object"
}
},
{
"description": "Delete a Serpzilla favorites list. With is_delete_sites=false (default) the domains are moved to the general favorites list; with true they are deleted along with the list.",
"inputSchema": {
"$defs": {
"FavoritesDeleteListArgs": {
"properties": {
"is_delete_sites": {
"default": false,
"description": "If true, domains are deleted along with the list. If false (default), domains are moved to the general favorites list.",
"title": "Is Delete Sites",
"type": "boolean"
},
"list_id": {
"description": "Favorites list ID",
"title": "List Id",
"type": "integer"
}
},
"required": [
"list_id"
],
"title": "FavoritesDeleteListArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/FavoritesDeleteListArgs"
}
},
"required": [
"args"
],
"title": "favorites_delete_listArguments",
"type": "object"
},
"name": "favorites_delete_list",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_delete_listOutput",
"type": "object"
}
},
{
"description": "Get domains from a Serpzilla favorites list (grouped into sections), with pagination and optional filters (sort order, domain zones, availability to buy).",
"inputSchema": {
"$defs": {
"FavoritesGetDomainsArgs": {
"properties": {
"domain_zones": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by domain zone IDs",
"title": "Domain Zones"
},
"favorite_list_id": {
"description": "Favorites list ID",
"title": "Favorite List Id",
"type": "integer"
},
"is_available_to_buy": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "false - ignore, true - only domains currently available for purchase",
"title": "Is Available To Buy"
},
"limit": {
"anyOf": [
{
"enum": [
250,
500,
1000,
5000
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domains per page (250/500/1000/5000)",
"title": "Limit"
},
"order_name": {
"anyOf": [
{
"enum": [
"byAlphabet",
"byCreatedAt"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort field: byAlphabet or byCreatedAt (default byCreatedAt)",
"title": "Order Name"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": 1,
"description": "Page number (starts at 1)",
"title": "Page"
}
},
"required": [
"favorite_list_id"
],
"title": "FavoritesGetDomainsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/FavoritesGetDomainsArgs"
}
},
"required": [
"args"
],
"title": "favorites_get_domainsArguments",
"type": "object"
},
"name": "favorites_get_domains",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_get_domainsOutput",
"type": "object"
}
},
{
"description": "Get all Serpzilla favorites lists with domain counts.",
"inputSchema": {
"properties": {},
"title": "favorites_get_listsArguments",
"type": "object"
},
"name": "favorites_get_lists",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_get_listsOutput",
"type": "object"
}
},
{
"description": "Move domains from one Serpzilla favorites list to another.",
"inputSchema": {
"$defs": {
"FavoritesMoveDomainsArgs": {
"properties": {
"domain_ids": {
"description": "Domain IDs to move",
"items": {
"type": "integer"
},
"minItems": 1,
"title": "Domain Ids",
"type": "array"
},
"from_list_id": {
"description": "Source favorites list ID",
"title": "From List Id",
"type": "integer"
},
"to_list_id": {
"description": "Target favorites list ID",
"title": "To List Id",
"type": "integer"
}
},
"required": [
"domain_ids",
"from_list_id",
"to_list_id"
],
"title": "FavoritesMoveDomainsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/FavoritesMoveDomainsArgs"
}
},
"required": [
"args"
],
"title": "favorites_move_domainsArguments",
"type": "object"
},
"name": "favorites_move_domains",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_move_domainsOutput",
"type": "object"
}
},
{
"description": "Rename a Serpzilla favorites list.",
"inputSchema": {
"$defs": {
"FavoritesRenameListArgs": {
"properties": {
"list_id": {
"description": "Favorites list ID",
"title": "List Id",
"type": "integer"
},
"list_name": {
"description": "New list name",
"minLength": 1,
"title": "List Name",
"type": "string"
}
},
"required": [
"list_id",
"list_name"
],
"title": "FavoritesRenameListArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/FavoritesRenameListArgs"
}
},
"required": [
"args"
],
"title": "favorites_rename_listArguments",
"type": "object"
},
"name": "favorites_rename_list",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "favorites_rename_listOutput",
"type": "object"
}
},
{
"description": "Get a list of content (articles and texts) in a Serpzilla project with filtering, sorting, and pagination. Supports status, type, URL IDs, and search by substring.",
"inputSchema": {
"$defs": {
"GetProjectContentListArgs": {
"properties": {
"async_url_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Async URL ID",
"title": "Async Url Id"
},
"content_status_ids": {
"anyOf": [
{
"items": {
"enum": [
0,
1,
2,
3,
5,
6,
7,
10,
11,
20,
30
],
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "List of content status IDs",
"title": "Content Status Ids"
},
"content_type": {
"anyOf": [
{
"enum": [
1,
3
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Content type: 1 - text, 3 - Guest Post",
"title": "Content Type"
},
"creation_source": {
"anyOf": [
{
"enum": [
0,
1
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Source of content creation: 0 - user, 1 - system",
"title": "Creation Source"
},
"from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "First entry position (offset)",
"title": "From"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of records",
"title": "Limit"
},
"order_by": {
"anyOf": [
{
"enum": [
"createdAt",
"text"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort field",
"title": "Order By"
},
"order_direction": {
"anyOf": [
{
"enum": [
"asc",
"desc"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort direction",
"title": "Order Direction"
},
"project_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Project ID",
"title": "Project Id"
},
"show_async_content_load": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Show only contents in process of adding",
"title": "Show Async Content Load"
},
"status": {
"anyOf": [
{
"enum": [
0,
1,
2,
3,
5,
6,
7,
10,
11,
20,
30
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Content status",
"title": "Status"
},
"substring_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Search by substring in content text",
"title": "Substring Text"
},
"url_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by URL IDs",
"title": "Url Ids"
}
},
"title": "GetProjectContentListArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/GetProjectContentListArgs"
}
},
"required": [
"args"
],
"title": "get_project_content_listArguments",
"type": "object"
},
"name": "get_project_content_list",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_project_content_listOutput",
"type": "object"
}
},
{
"description": "Get a list of all placements in a Serpzilla project.",
"inputSchema": {
"$defs": {
"GetProjectPlacementsArgs": {
"properties": {
"project_id": {
"description": "Project ID",
"title": "Project Id",
"type": "integer"
}
},
"required": [
"project_id"
],
"title": "GetProjectPlacementsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/GetProjectPlacementsArgs"
}
},
"required": [
"args"
],
"title": "get_project_placementsArguments",
"type": "object"
},
"name": "get_project_placements",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_project_placementsOutput",
"type": "object"
}
},
{
"description": "Get detailed information about a Serpzilla donor site (site card), including metrics, price, status, languages, statistics, etc.",
"inputSchema": {
"$defs": {
"GetSiteInfoArgs": {
"properties": {
"site_id": {
"description": "Site ID",
"title": "Site Id",
"type": "integer"
}
},
"required": [
"site_id"
],
"title": "GetSiteInfoArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/GetSiteInfoArgs"
}
},
"required": [
"args"
],
"title": "get_site_infoArguments",
"type": "object"
},
"name": "get_site_info",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_site_infoOutput",
"type": "object"
}
},
{
"description": "Get current Serpzilla user information including account balance (balance field). To top up your balance, visit https://passport.serpzilla.com/deposit/",
"inputSchema": {
"properties": {},
"title": "get_user_infoArguments",
"type": "object"
},
"name": "get_user_info",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_user_infoOutput",
"type": "object"
}
},
{
"description": "Get list of existing Serpzilla projects with optional pagination, sorting, and filtering. All parameters are optional; calling without arguments returns the first page.",
"inputSchema": {
"$defs": {
"ListProjectsArgs": {
"properties": {
"limit": {
"anyOf": [
{
"enum": [
20,
50,
100,
250
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Projects per page",
"title": "Limit"
},
"order_by": {
"anyOf": [
{
"enum": [
"byProjectName",
"byLinksCount",
"byUrlsCount",
"byAutobuyersCount",
"byMonthlyBudget",
"byCreatedAt"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort field",
"title": "Order By"
},
"order_type": {
"anyOf": [
{
"enum": [
"asc",
"desc"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort direction",
"title": "Order Type"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Page number (starts at 1)",
"title": "Page"
},
"project_filter": {
"anyOf": [
{
"enum": [
"all",
"isActive",
"isArchived",
"withErrors"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Status filter: all, isActive (write-offs in last 24h), isArchived, withErrors",
"title": "Project Filter"
},
"projects_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by specific project IDs",
"title": "Projects Ids"
}
},
"title": "ListProjectsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/ListProjectsArgs"
}
},
"required": [
"args"
],
"title": "list_projectsArguments",
"type": "object"
},
"name": "list_projects",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "list_projectsOutput",
"type": "object"
}
},
{
"description": "Perform an action on one or more Serpzilla placements (e.g., approve, cancel). Allowed actions: force_billing_seo, approve_seo, approve_content_seo, approve_from_arbitration_seo, cancel_from_on_placement_seo, cancel_from_improve_seo, cancel_seo, terminate_seo, cancel_order_change_links_seo, price_changing_action_accept_seo, guarantee_wm, accept_order_change_links_wm, price_changing_action_reject_wm, delete_draft_seo, buy_from_buy_fail_seo, delete_from_buy_fail_seo.",
"inputSchema": {
"$defs": {
"PerformPlacementActionArgs": {
"properties": {
"action": {
"description": "Action to perform (see list)",
"enum": [
"force_billing_seo",
"approve_seo",
"approve_content_seo",
"approve_from_arbitration_seo",
"cancel_from_on_placement_seo",
"cancel_from_improve_seo",
"cancel_seo",
"terminate_seo",
"cancel_order_change_links_seo",
"price_changing_action_accept_seo",
"guarantee_wm",
"accept_order_change_links_wm",
"price_changing_action_reject_wm",
"delete_draft_seo",
"buy_from_buy_fail_seo",
"delete_from_buy_fail_seo",
"sleep_manual_seo",
"unsleep_manual_seo",
"order_change_links_texts_seo"
],
"title": "Action",
"type": "string"
},
"placement_ids": {
"description": "List of placement IDs to apply the action to",
"items": {
"type": "integer"
},
"title": "Placement Ids",
"type": "array"
}
},
"required": [
"action",
"placement_ids"
],
"title": "PerformPlacementActionArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/PerformPlacementActionArgs"
}
},
"required": [
"args"
],
"title": "perform_placement_actionArguments",
"type": "object"
},
"name": "perform_placement_action",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "perform_placement_actionOutput",
"type": "object"
}
},
{
"description": "Purchase contextual (Niche Edit) link placements on selected Serpzilla donor pages. The search_id, force_seo_wait, mos_sites, and pages_extra values must come from a prior search_context_sites call (data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra). Each item in pages needs: page_id = donor page ID (resultList[].pages[].id from the search response); url_id = promoted URL ID; text = the ANCHOR: a short phrase copied VERBATIM from the chosen snippet — it becomes the link (NO #a#...#/a# markup is used for contextual placements); full_text = that same snippet copied UNCHANGED from resultList[].pages[].snippets[] — the API matches the anchor inside this snippet, so keep its wording and HTML tags (e.g. <b>) intact. Example: for the snippet '- качественно и с душой( <b>Натяжные потолки</b> с точечной подсветкой' use text='Натяжные потолки' and full_text=the whole snippet string. Returns the created placement IDs.",
"inputSchema": {
"$defs": {
"ContextPurchasePage": {
"description": "A single donor page to purchase a contextual link on.",
"properties": {
"full_text": {
"description": "The FULL snippet text copied UNCHANGED from the search results (resultList[].pages[].snippets[] of the search_context_sites response), including any HTML tags it contains. The API matches the anchor (text) inside this snippet, so do not edit or reformat it.",
"title": "Full Text",
"type": "string"
},
"page_id": {
"description": "Donor page ID (from search results resultList[].pages[].id)",
"title": "Page Id",
"type": "integer"
},
"text": {
"description": "ANCHOR phrase that will become the link. Must be copied VERBATIM from the full_text snippet (a contiguous fragment of its plain text, ignoring any HTML tags like <b>). Example: if the snippet is '- качественно и с душой( <b>Натяжные потолки</b> с точечной подсветкой', a valid text is 'Натяжные потолки'. Do NOT use #a#...#/a# markup here — that markup is not used for contextual placements.",
"title": "Text",
"type": "string"
},
"url_id": {
"description": "Promoted URL ID",
"title": "Url Id",
"type": "integer"
}
},
"required": [
"page_id",
"url_id",
"text",
"full_text"
],
"title": "ContextPurchasePage",
"type": "object"
},
"PurchaseContextPlacementArgs": {
"description": "Arguments for purchasing contextual (Niche Edit) link placements on donor pages.",
"properties": {
"force_seo_wait": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 0,
"description": "Forced status for sites with auto-reception (from search results data.forceSeoWait). 0 = confirm with open URLs, send with closed URLs to applications; 1 = send with open and closed URLs to applications; 2 = confirm with open and closed URLs",
"title": "Force Seo Wait"
},
"mos_sites": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Encoded list of MOS sites (pass data.mosSites from search results verbatim; omit if absent)",
"title": "Mos Sites"
},
"pages": {
"description": "List of pages to purchase links on",
"items": {
"$ref": "#/$defs/ContextPurchasePage"
},
"title": "Pages",
"type": "array"
},
"pages_extra": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Encoded list of pages for additional WAITs (pass data.pagesExtra from search results verbatim; omit if absent)",
"title": "Pages Extra"
},
"project_id": {
"description": "Project ID",
"title": "Project Id",
"type": "integer"
},
"search_id": {
"description": "Search ID (from search results data.searchId)",
"title": "Search Id",
"type": "integer"
}
},
"required": [
"project_id",
"search_id",
"pages"
],
"title": "PurchaseContextPlacementArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/PurchaseContextPlacementArgs"
}
},
"required": [
"args"
],
"title": "purchase_context_placementArguments",
"type": "object"
},
"name": "purchase_context_placement",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "purchase_context_placementOutput",
"type": "object"
}
},
{
"description": "Purchase a placement on a selected Serpzilla donor site.",
"inputSchema": {
"$defs": {
"PurchasePlacementArgs": {
"properties": {
"article_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Article ID (required for news placements)",
"title": "Article Id"
},
"is_content_need_approval": {
"default": false,
"description": "Whether content approval is required",
"title": "Is Content Need Approval",
"type": "boolean"
},
"link_type": {
"description": "Placement type",
"enum": [
"news",
"review",
"link",
"archive"
],
"title": "Link Type",
"type": "string"
},
"project_id": {
"description": "Project ID",
"title": "Project Id",
"type": "integer"
},
"search_history_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Search history ID",
"title": "Search History Id"
},
"site_id": {
"description": "Donor site ID",
"title": "Site Id",
"type": "integer"
},
"text_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Text ID (required for review, link, archive; not used for news)",
"title": "Text Id"
},
"url_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Promoted URL ID (required for all placement types)",
"title": "Url Id"
}
},
"required": [
"project_id",
"site_id",
"link_type"
],
"title": "PurchasePlacementArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/PurchasePlacementArgs"
}
},
"required": [
"args"
],
"title": "purchase_placementArguments",
"type": "object"
},
"name": "purchase_placement",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "purchase_placementOutput",
"type": "object"
}
},
{
"description": "Purchase rental (monthly-billed) link placements on selected Serpzilla donor pages. The search_id, force_seo_wait, mos_sites, and pages_extra values must come from a prior search_rent_sites call (data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra). Each page in pages needs: page_id (donor page ID from search results resultList[].pages[].id), url_id (promoted URL ID), and text_id (anchor text ID). Returns the created placement IDs.",
"inputSchema": {
"$defs": {
"PurchaseRentPlacementArgs": {
"description": "Arguments for purchasing rental (monthly-billed) link placements.",
"properties": {
"force_seo_wait": {
"anyOf": [
{
"enum": [
0,
1,
2
],
"type": "integer"
},
{
"type": "null"
}
],
"default": 0,
"description": "Forced status for sites with auto-reception (from search results data.forceSeoWait). 0 - confirm with open URLs, send with closed URLs to applications; 1 - send with open and closed URLs to applications; 2 - confirm with open and closed URLs",
"title": "Force Seo Wait"
},
"link_type_id": {
"anyOf": [
{
"enum": [
1,
2,
3,
4
],
"type": "integer"
},
{
"type": "null"
}
],
"default": 1,
"description": "Niche Edit link type: 1 - rent, 2 - context, 3 - relevant, 4 - sitewide",
"title": "Link Type Id"
},
"mos_sites": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "Encoded list of MOS sites (from search results data.mosSites)",
"title": "Mos Sites"
},
"pages": {
"description": "List of pages to purchase links on",
"items": {
"$ref": "#/$defs/RentPurchasePage"
},
"title": "Pages",
"type": "array"
},
"pages_extra": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "Encoded list of pages for additional WAITs (from search results data.pagesExtra)",
"title": "Pages Extra"
},
"project_id": {
"description": "Project ID",
"title": "Project Id",
"type": "integer"
},
"search_id": {
"description": "Search ID (from search results data.searchId)",
"title": "Search Id",
"type": "integer"
}
},
"required": [
"project_id",
"search_id",
"pages"
],
"title": "PurchaseRentPlacementArgs",
"type": "object"
},
"RentPurchasePage": {
"description": "A single donor page to purchase a rental link on.",
"properties": {
"page_id": {
"description": "Donor page ID (from search results resultList[].pages[].id)",
"title": "Page Id",
"type": "integer"
},
"text_id": {
"description": "Text (anchor) ID",
"title": "Text Id",
"type": "integer"
},
"url_id": {
"description": "Promoted URL ID",
"title": "Url Id",
"type": "integer"
}
},
"required": [
"page_id",
"url_id",
"text_id"
],
"title": "RentPurchasePage",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/PurchaseRentPlacementArgs"
}
},
"required": [
"args"
],
"title": "purchase_rent_placementArguments",
"type": "object"
},
"name": "purchase_rent_placement",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "purchase_rent_placementOutput",
"type": "object"
}
},
{
"description": "Search Serpzilla donor sites for contextual (Niche Edit) links by URL ID and filters. The search runs asynchronously: this tool polls internally until results are ready (up to 150s) and returns them. The response contains data.resultList (found sites, each with nested pages[] where pages[].id = pageId identifies a purchasable donor page and pages[].snippets[] lists text fragments of that page where a link can be inserted). When buying later via purchase_context_placement, pass the chosen snippet UNCHANGED as its full_text and pick the anchor phrase inside it as its text. The response also carries the echo values needed to buy: data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra — pass those plus the selected page IDs into purchase_context_placement.",
"inputSchema": {
"$defs": {
"SearchContextSitesArgs": {
"description": "Search donor sites for contextual (Niche Edit) links.",
"properties": {
"ahrefs_backlinks_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total backlinks from",
"title": "Ahrefs Backlinks From"
},
"ahrefs_backlinks_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total backlinks to",
"title": "Ahrefs Backlinks To"
},
"ahrefs_dr_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs DR from",
"title": "Ahrefs Dr From"
},
"ahrefs_dr_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs DR to",
"title": "Ahrefs Dr To"
},
"ahrefs_keywords_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total keywords from",
"title": "Ahrefs Keywords From"
},
"ahrefs_keywords_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total keywords to",
"title": "Ahrefs Keywords To"
},
"avg_placement_time_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum placement time in days",
"title": "Avg Placement Time From"
},
"avg_placement_time_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum placement time in days",
"title": "Avg Placement Time To"
},
"days_old_whois_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain age in days from",
"title": "Days Old Whois From"
},
"domain_level": {
"anyOf": [
{
"enum": [
0,
2,
3
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain level: 0 - all, 2 - only second level, 3 - only third",
"title": "Domain Level"
},
"domain_zones": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain zone IDs",
"title": "Domain Zones"
},
"donor_domain": {
"anyOf": [
{
"maxLength": 255,
"minLength": 3,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Donor site domain/URL to filter by (e.g., example.com), scheme optional",
"title": "Donor Domain"
},
"external_links_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of external links on donor",
"title": "External Links To"
},
"favorite_lists_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Search only within these favorites list IDs",
"title": "Favorite Lists Ids"
},
"is_credit_available": {
"anyOf": [
{
"enum": [
0,
1,
2
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Credit available: 0 - all, 1 - only yes, 2 - only no",
"title": "Is Credit Available"
},
"is_in_favorite_lists": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Search favorite lists only (donors already added to favorites)",
"title": "Is In Favorite Lists"
},
"keywords": {
"description": "Keywords separated by commas",
"title": "Keywords",
"type": "string"
},
"limit": {
"anyOf": [
{
"enum": [
50,
100,
250
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Results per page (50, 100, or 250)",
"title": "Limit"
},
"majestic_cf_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Citation Flow from",
"title": "Majestic Cf From"
},
"majestic_cf_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Citation Flow to",
"title": "Majestic Cf To"
},
"majestic_tf_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Trust Flow from",
"title": "Majestic Tf From"
},
"majestic_tf_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Trust Flow to",
"title": "Majestic Tf To"
},
"moz_da_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Domain Authority from",
"title": "Moz Da From"
},
"moz_da_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Domain Authority to",
"title": "Moz Da To"
},
"moz_spam_score_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Spam Score from",
"title": "Moz Spam Score From"
},
"moz_spam_score_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Spam Score to",
"title": "Moz Spam Score To"
},
"nof_pages_google_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum number of pages in Google index",
"title": "Nof Pages Google From"
},
"nof_pages_google_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of pages in Google index",
"title": "Nof Pages Google To"
},
"nof_pages_yandex_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum number of pages in Yandex index",
"title": "Nof Pages Yandex From"
},
"nof_pages_yandex_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of pages in Yandex index",
"title": "Nof Pages Yandex To"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": 1,
"description": "Page number (starts at 1)",
"title": "Page"
},
"placement_probability_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum placement probability percentage",
"title": "Placement Probability From"
},
"placement_probability_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum placement probability percentage",
"title": "Placement Probability To"
},
"price_rent_from": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum monthly rental price",
"title": "Price Rent From"
},
"price_rent_to": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum monthly rental price",
"title": "Price Rent To"
},
"search_rent_order": {
"anyOf": [
{
"enum": [
0,
1,
11,
2,
12,
3,
13,
1000,
100,
1001,
101,
1002,
102,
1003,
103,
1004,
104,
1005,
105,
4,
14,
5,
15,
6,
16,
7,
17,
8,
18,
9,
19,
201,
2001,
202,
2002
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort order for results",
"title": "Search Rent Order"
},
"semrush_as_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush AS (Authority Score) from",
"title": "Semrush As From"
},
"semrush_as_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush AS to",
"title": "Semrush As To"
},
"site_languages": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Site languages (e.g. ['ru', 'en'])",
"title": "Site Languages"
},
"traffic_ahrefs_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs traffic from",
"title": "Traffic Ahrefs From"
},
"traffic_semrush_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush traffic from",
"title": "Traffic Semrush From"
},
"traffic_system_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "System traffic from",
"title": "Traffic System From"
},
"traffic_yandex_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Yandex traffic from",
"title": "Traffic Yandex From"
},
"url_id": {
"description": "Promoted URL ID to search donors for",
"title": "Url Id",
"type": "integer"
},
"yandex_sqi_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Yandex SQI from",
"title": "Yandex Sqi From"
},
"yandex_sqi_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Yandex SQI to",
"title": "Yandex Sqi To"
}
},
"required": [
"url_id",
"keywords"
],
"title": "SearchContextSitesArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/SearchContextSitesArgs"
}
},
"required": [
"args"
],
"title": "search_context_sitesArguments",
"type": "object"
},
"name": "search_context_sites",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "search_context_sitesOutput",
"type": "object"
}
},
{
"description": "Search Serpzilla donor sites for rental (monthly-billed) links by URL ID and filters. The search runs asynchronously: this tool polls internally until results are ready (up to 150s) and returns them. The response contains data.resultList (found sites, each with nested pages[].id = pageId identifying purchasable donor pages) and the echo values needed to buy: data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra. Pass those echo values plus selected page IDs into the purchase_rent_placement tool.",
"inputSchema": {
"$defs": {
"SearchRentSitesArgs": {
"description": "Search donor sites for rental (monthly-billed) links.",
"properties": {
"ahrefs_backlinks_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total backlinks from",
"title": "Ahrefs Backlinks From"
},
"ahrefs_backlinks_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total backlinks to",
"title": "Ahrefs Backlinks To"
},
"ahrefs_dr_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs DR from",
"title": "Ahrefs Dr From"
},
"ahrefs_dr_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs DR to",
"title": "Ahrefs Dr To"
},
"ahrefs_keywords_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total keywords from",
"title": "Ahrefs Keywords From"
},
"ahrefs_keywords_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total keywords to",
"title": "Ahrefs Keywords To"
},
"avg_placement_time_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum placement time in days",
"title": "Avg Placement Time From"
},
"avg_placement_time_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum placement time in days",
"title": "Avg Placement Time To"
},
"days_old_whois_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain age in days from",
"title": "Days Old Whois From"
},
"domain_level": {
"anyOf": [
{
"enum": [
0,
2,
3
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain level: 0 - all, 2 - only second level, 3 - only third",
"title": "Domain Level"
},
"domain_zones": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain zone IDs",
"title": "Domain Zones"
},
"donor_domain": {
"anyOf": [
{
"maxLength": 255,
"minLength": 3,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Donor site domain/URL to filter by (e.g., example.com), scheme optional",
"title": "Donor Domain"
},
"external_links_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of external links on donor",
"title": "External Links To"
},
"favorite_lists_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Search only within these favorites list IDs",
"title": "Favorite Lists Ids"
},
"is_credit_available": {
"anyOf": [
{
"enum": [
0,
1,
2
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Credit available: 0 - all, 1 - only yes, 2 - only no",
"title": "Is Credit Available"
},
"is_in_favorite_lists": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Search favorite lists only (donors already added to favorites)",
"title": "Is In Favorite Lists"
},
"keywords": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Keywords separated by commas",
"title": "Keywords"
},
"limit": {
"anyOf": [
{
"enum": [
50,
100,
250
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Results per page (50, 100, or 250)",
"title": "Limit"
},
"majestic_cf_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Citation Flow from",
"title": "Majestic Cf From"
},
"majestic_cf_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Citation Flow to",
"title": "Majestic Cf To"
},
"majestic_tf_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Trust Flow from",
"title": "Majestic Tf From"
},
"majestic_tf_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Trust Flow to",
"title": "Majestic Tf To"
},
"moz_da_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Domain Authority from",
"title": "Moz Da From"
},
"moz_da_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Domain Authority to",
"title": "Moz Da To"
},
"moz_spam_score_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Spam Score from",
"title": "Moz Spam Score From"
},
"moz_spam_score_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Spam Score to",
"title": "Moz Spam Score To"
},
"nof_pages_google_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum number of pages in Google index",
"title": "Nof Pages Google From"
},
"nof_pages_google_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of pages in Google index",
"title": "Nof Pages Google To"
},
"nof_pages_yandex_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum number of pages in Yandex index",
"title": "Nof Pages Yandex From"
},
"nof_pages_yandex_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of pages in Yandex index",
"title": "Nof Pages Yandex To"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": 1,
"description": "Page number (starts at 1)",
"title": "Page"
},
"placement_probability_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum placement probability percentage",
"title": "Placement Probability From"
},
"placement_probability_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum placement probability percentage",
"title": "Placement Probability To"
},
"price_rent_from": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum monthly rental price",
"title": "Price Rent From"
},
"price_rent_to": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum monthly rental price",
"title": "Price Rent To"
},
"search_rent_order": {
"anyOf": [
{
"enum": [
0,
1,
11,
2,
12,
3,
13,
1000,
100,
1001,
101,
1002,
102,
1003,
103,
1004,
104,
1005,
105,
4,
14,
5,
15,
6,
16,
7,
17,
8,
18,
9,
19,
201,
2001,
202,
2002
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort order for results",
"title": "Search Rent Order"
},
"semrush_as_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush AS (Authority Score) from",
"title": "Semrush As From"
},
"semrush_as_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush AS to",
"title": "Semrush As To"
},
"site_languages": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Site languages (e.g. ['ru', 'en'])",
"title": "Site Languages"
},
"traffic_ahrefs_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs traffic from",
"title": "Traffic Ahrefs From"
},
"traffic_semrush_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush traffic from",
"title": "Traffic Semrush From"
},
"traffic_system_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "System traffic from",
"title": "Traffic System From"
},
"traffic_yandex_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Yandex traffic from",
"title": "Traffic Yandex From"
},
"url_id": {
"description": "Promoted URL ID to search donors for",
"title": "Url Id",
"type": "integer"
},
"yandex_sqi_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Yandex SQI (ИКС) from",
"title": "Yandex Sqi From"
},
"yandex_sqi_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Yandex SQI (ИКС) to",
"title": "Yandex Sqi To"
}
},
"required": [
"url_id"
],
"title": "SearchRentSitesArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/SearchRentSitesArgs"
}
},
"required": [
"args"
],
"title": "search_rent_sitesArguments",
"type": "object"
},
"name": "search_rent_sites",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "search_rent_sitesOutput",
"type": "object"
}
},
{
"description": "Search Serpzilla donor sites by given filters.",
"inputSchema": {
"$defs": {
"SearchSitesArgs": {
"description": "Search donor sites with filters.",
"properties": {
"ahrefs_backlinks_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total backlinks from",
"title": "Ahrefs Backlinks From"
},
"ahrefs_backlinks_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total backlinks to",
"title": "Ahrefs Backlinks To"
},
"ahrefs_dr_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs DR from",
"title": "Ahrefs Dr From"
},
"ahrefs_dr_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs DR to",
"title": "Ahrefs Dr To"
},
"ahrefs_keywords_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total keywords from",
"title": "Ahrefs Keywords From"
},
"ahrefs_keywords_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs total keywords to",
"title": "Ahrefs Keywords To"
},
"avg_placement_time_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum placement time in days",
"title": "Avg Placement Time From"
},
"avg_placement_time_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum placement time in days",
"title": "Avg Placement Time To"
},
"days_old_whois_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain age in days from",
"title": "Days Old Whois From"
},
"domain_level": {
"anyOf": [
{
"enum": [
0,
2,
3
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Domain level: 0 - all, 2 - only second level, 3 - only third",
"title": "Domain Level"
},
"donor_domain": {
"anyOf": [
{
"maxLength": 255,
"minLength": 3,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Donor site domain/URL to filter by (e.g., example.com), scheme optional",
"title": "Donor Domain"
},
"external_links_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of external links on donor",
"title": "External Links To"
},
"favorite_lists_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Search only within these favorites list IDs",
"title": "Favorite Lists Ids"
},
"is_in_favorite_lists": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Search favorite lists only (donors already added to favorites)",
"title": "Is In Favorite Lists"
},
"keywords": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Keywords separated by commas",
"title": "Keywords"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Site language",
"title": "Language"
},
"limit": {
"anyOf": [
{
"enum": [
20,
50,
100,
250,
1000
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Results per page (up to 1000 elements)",
"title": "Limit"
},
"link_type": {
"description": "Placement type: news, review, link, archive",
"enum": [
"news",
"review",
"link",
"archive"
],
"title": "Link Type",
"type": "string"
},
"majestic_cf_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Citation Flow from",
"title": "Majestic Cf From"
},
"majestic_cf_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Citation Flow to",
"title": "Majestic Cf To"
},
"majestic_tf_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Trust Flow from",
"title": "Majestic Tf From"
},
"majestic_tf_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Majestic Trust Flow to",
"title": "Majestic Tf To"
},
"moz_da_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Domain Authority from",
"title": "Moz Da From"
},
"moz_da_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Domain Authority to",
"title": "Moz Da To"
},
"moz_page_authority_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Page Authority from",
"title": "Moz Page Authority From"
},
"moz_page_authority_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Page Authority to",
"title": "Moz Page Authority To"
},
"moz_page_rank_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Page Rank from",
"title": "Moz Page Rank From"
},
"moz_page_rank_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Page Rank to",
"title": "Moz Page Rank To"
},
"moz_spam_score_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Spam Score from",
"title": "Moz Spam Score From"
},
"moz_spam_score_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Moz Spam Score to",
"title": "Moz Spam Score To"
},
"order_by": {
"anyOf": [
{
"enum": [
"default",
"url",
"sqi",
"percentIndexed",
"avgPlacementTime",
"price",
"domainRating",
"mozDomainAuthority",
"mozSpamScore",
"semrushAscore",
"semrushDomainsNum",
"trafficSemrush",
"trafficAhrefs",
"trafficSystem",
"trafficYandex",
"trafficLi"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort field",
"title": "Order By"
},
"order_type": {
"anyOf": [
{
"enum": [
"asc",
"desc"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort direction (deprecated in upstream API)",
"title": "Order Type"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Page number (starts at 1)",
"title": "Page"
},
"pages_google_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum number of pages in Google index",
"title": "Pages Google From"
},
"pages_google_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum number of pages in Google index",
"title": "Pages Google To"
},
"placement_probability_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum placement probability percentage",
"title": "Placement Probability From"
},
"placement_probability_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum placement probability percentage",
"title": "Placement Probability To"
},
"price_from": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum price",
"title": "Price From"
},
"price_to": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum price",
"title": "Price To"
},
"project_id": {
"description": "Project ID",
"title": "Project Id",
"type": "integer"
},
"semrush_as_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush AS (Authority Score) from",
"title": "Semrush As From"
},
"semrush_as_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush AS to",
"title": "Semrush As To"
},
"semrush_domains_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush number of domains from",
"title": "Semrush Domains From"
},
"semrush_domains_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush number of domains to",
"title": "Semrush Domains To"
},
"traffic_ahrefs_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ahrefs traffic from",
"title": "Traffic Ahrefs From"
},
"traffic_semrush_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Semrush traffic from",
"title": "Traffic Semrush From"
}
},
"required": [
"project_id",
"link_type"
],
"title": "SearchSitesArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/SearchSitesArgs"
}
},
"required": [
"args"
],
"title": "search_sitesArguments",
"type": "object"
},
"name": "search_sites",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "search_sitesOutput",
"type": "object"
}
},
{
"description": "Set usage limits for Serpzilla content (anchors/texts). Targets either specific content IDs or all content of a URL. Limit 0 means no restrictions.",
"inputSchema": {
"$defs": {
"SetLimitsArgs": {
"properties": {
"content_ids": {
"anyOf": [
{
"items": {
"type": "integer"
},
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Content IDs to apply the limit to",
"title": "Content Ids"
},
"limit": {
"anyOf": [
{
"maximum": 32767,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Max number of uses; 0 - no restrictions",
"title": "Limit"
},
"url_id": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "If provided, the limit applies to ALL content of this URL",
"title": "Url Id"
}
},
"title": "SetLimitsArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/SetLimitsArgs"
}
},
"required": [
"args"
],
"title": "set_limitsArguments",
"type": "object"
},
"name": "set_limits",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "set_limitsOutput",
"type": "object"
}
},
{
"description": "Update a Serpzilla promoted URL: URL, title and link decoration (hiding links from search engines). The url field is required; pass the current URL unchanged if it should not be modified.",
"inputSchema": {
"$defs": {
"UpdateUrlArgs": {
"properties": {
"link_decoration": {
"anyOf": [
{
"enum": [
0,
1,
2,
3
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Hide links with this URL from search engines: 0 - do not hide; 1 - Google rel=nofollow; 2 - rel=sponsored; 3 - Yandex <noindex>",
"title": "Link Decoration"
},
"name": {
"anyOf": [
{
"maxLength": 50,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "URL title",
"title": "Name"
},
"url": {
"description": "New URL as a string with scheme and www (if available)",
"maxLength": 1500,
"minLength": 1,
"title": "Url",
"type": "string"
},
"url_id": {
"description": "URL ID",
"minimum": 1,
"title": "Url Id",
"type": "integer"
}
},
"required": [
"url_id",
"url"
],
"title": "UpdateUrlArgs",
"type": "object"
}
},
"properties": {
"args": {
"$ref": "#/$defs/UpdateUrlArgs"
}
},
"required": [
"args"
],
"title": "update_urlArguments",
"type": "object"
},
"name": "update_url",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "update_urlOutput",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:6610e727eb921b1095572e0766a331430c91cf1479e143b4f03825e9077a863a | sha256sum