# Serpstat

> Research SEO with Serpstat: find keywords and their search volume, see who ranks, analyse domains, pages, competitors and backlinks, and read rank tracker positions and site audit scores.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/serpstat

## Actions

### Find domain competitors

Find the domains that compete with a domain in organic search, with their visibility, traffic and how relevant each is.

**Inputs**

- Domain (`domain`, text, required): The domain to find competitors for.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Number of competitors (`size`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Leave out domains (`minus_domains`, list): Domains to leave out of the results, up to 50.

**Outputs**

- `data` (list): The competitors
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "domain": "competitor.example",
      "keywords": 180000,
      "relevance": 42,
      "traff": 1200000,
      "visible": 9.1
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Find keywords

Find search keywords that contain a word or phrase, with monthly search volume, cost per click, competition and difficulty. Each keyword returned costs a credit.

**Inputs**

- Keyword (`keyword`, text, required): The word or phrase the keywords must contain.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Leave out keywords containing (`minus_keywords`, list): Words or phrases; keywords containing any of them are left out (up to 50).
- Minimum search volume (`min_search_volume`, number): Only keywords searched at least this many times a month. At least 0.
- Maximum search volume (`max_search_volume`, number): Only keywords searched at most this many times a month. At least 0.
- Maximum difficulty (`max_difficulty`, number): Only keywords with a difficulty (0 to 100) at most this. From 0 to 100.
- Search intent (`intents`, list): Only keywords with one of these search intents. One or more of: `informational`, `navigational`, `commercial`, `transactional`.
- Include search intent (`include_intents`, true/false): Add each keyword's search intent (informational, navigational, commercial or transactional).
- Sort by (`sort_by`, text): What to sort the results by. Leave empty for Serpstat's order. One of: `region_queries_count` (Search volume), `cost` (Cost per click), `difficulty` (Keyword difficulty), `concurrency` (Competition), `found_results` (Number of results), `keyword_length` (Keyword length).
- Sort order (`sort_order`, text): Highest or lowest first. Defaults to highest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The keywords
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "concurrency": 100,
      "cost": 1.25,
      "difficulty": 62,
      "found_results": 512000000,
      "intents": [
        "commercial"
      ],
      "keyword": "best running shoes",
      "keyword_length": 3,
      "lang": "en",
      "region_queries_count": 74000,
      "region_queries_count_wide": 90500,
      "types": [
        "pic",
        "video"
      ]
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Find related keywords

Find keywords that mean much the same as a keyword (semantically related), with search volume, cost per click, difficulty and how closely each is related. Each keyword returned costs a credit.

**Inputs**

- Keyword (`keyword`, text, required): The keyword to find related keywords for.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Minimum search volume (`min_search_volume`, number): Only keywords searched at least this many times a month. At least 0.
- Maximum search volume (`max_search_volume`, number): Only keywords searched at most this many times a month. At least 0.
- Maximum difficulty (`max_difficulty`, number): Only keywords with a difficulty (0 to 100) at most this. From 0 to 100.
- Include search intent (`include_intents`, true/false): Add each keyword's search intent (informational, navigational, commercial or transactional).
- Sort by (`sort_by`, text): What to sort the results by. Leave empty for Serpstat's order. One of: `weight` (Relatedness), `region_queries_count` (Search volume), `cost` (Cost per click), `difficulty` (Keyword difficulty), `concurrency` (Competition), `keyword` (Keyword (A to Z)).
- Sort order (`sort_order`, text): Highest or lowest first. Defaults to highest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The related keywords
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "concurrency": 100,
      "cost": 0.95,
      "difficulty": 48,
      "intents": [
        "commercial"
      ],
      "keyword": "trail running shoes",
      "keyword_length": 3,
      "region_queries_count": 33100,
      "types": [
        "pic"
      ],
      "weight": 7
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Get API credits

See how many API credits your Serpstat plan has, how many are used and how many are left. This step is free.

**Inputs**: None.

**Outputs**

- `data` (object): The plan's API credits
- `summary_info` (object): The credits left

**Example output**

```json
{
  "data": {
    "left_lines": 99950,
    "max_lines": 100000,
    "plugin_limits": {
      "hasApiPlugin": true,
      "left": 1000,
      "total": 1000,
      "used": 0
    },
    "used_lines": 50,
    "user_info": {
      "plan_id": "team",
      "user_id": "12345"
    }
  },
  "summary_info": {
    "left_lines": 99950
  }
}
```

### Get backlink summary

Get a domain's backlink profile: Serpstat domain rank, referring domains, backlinks by type, and how each changed.

**Inputs**

- Domain (`domain`, text, required): The domain whose backlinks to summarise.
- Include subdomains (`search_type`, text): The domain alone, or with its subdomains. Defaults to the domain alone. One of: `domain` (This domain only), `domain_with_subdomains` (Domain and its subdomains). Default: `domain`.

**Outputs**

- `data` (object): The backlink profile
- `summary_info` (object): The credits left

**Example output**

```json
{
  "data": {
    "backlinks": 900000,
    "backlinks_change": 3400,
    "backlinks_from_mainpages": 4000,
    "dofollow_backlinks": 700000,
    "external_domains": 800,
    "external_links": 4000,
    "image_backlinks": 60000,
    "nofollow_backlinks": 200000,
    "redirect_backlinks": 20000,
    "referring_domains": 25000,
    "referring_domains_change": 120,
    "referring_ip_addresses": 18000,
    "referring_malicious_domains": 3,
    "referring_subnets": 9000,
    "sersptat_domain_rank": 71,
    "text_backlinks": 820000
  },
  "summary_info": {
    "left_lines": 99949
  }
}
```

### Get backlinks

List the live backlinks pointing at a domain or page, with the linking page, anchor text, link type and when each was found. Each link returned costs a credit.

**Inputs**

- Domain or URL (`target`, text, required): The domain, or the page's address, whose backlinks to read.
- Look at (`search_type`, text): What the domain or URL covers. Defaults to the domain alone. One of: `domain` (This domain only), `domain_with_subdomains` (Domain and its subdomains), `url` (This exact URL), `part_url` (URLs starting with this address). Default: `domain`.
- One link per domain (`one_link_per_domain`, true/false): Show only one backlink from each linking domain.
- Sort by (`sort_by`, text): What to sort the results by. Leave empty for Serpstat's order. One of: `check` (Date found), `add` (Date added), `domain_rank` (Linking domain's rank), `url_from` (Linking page), `url_to` (Linked page), `anchor` (Anchor text), `links_external` (Outgoing links on the page).
- Sort order (`sort_order`, text): Highest or lowest first. Defaults to highest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The backlinks
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "domain_rank": "54",
      "first_seen": "2026-10-01",
      "last_visited": "2026-11-01",
      "link_text": "Example shoes",
      "link_type": "href",
      "links_ext": 12,
      "nofollow": "follow",
      "url_from": "https://blog.example.org/review",
      "url_to": "https://example.com/"
    }
  ],
  "summary_info": {
    "count": 1,
    "left_lines": 99950,
    "order": "desc",
    "page": 1,
    "sort": "check",
    "total": 1
  }
}
```

### Get domain keywords

List the keywords a domain ranks for in the top 100, with its position, page, traffic, search volume and difficulty. Each keyword returned costs a credit.

**Inputs**

- Domain (`domain`, text, required): The domain whose keywords to list.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Include subdomains (`with_subdomains`, true/false): Also count keywords its subdomains rank for.
- Include search intent (`include_intents`, true/false): Add each keyword's search intent (informational, navigational, commercial or transactional).
- Keyword contains (`keyword_contains`, text): Only keywords containing this text.
- Best position (`position_from`, number): Only keywords ranking at this position or lower (1 to 100). From 1 to 100.
- Worst position (`position_to`, number): Only keywords ranking at this position or better (1 to 100). From 1 to 100.
- Minimum search volume (`min_search_volume`, number): Only keywords searched at least this many times a month. At least 0.
- Sort by (`sort_by`, text): What to sort the results by. Leave empty for Serpstat's order. One of: `position`, `traff` (Traffic), `region_queries_count` (Search volume), `cost` (Cost per click), `difficulty` (Keyword difficulty), `concurrency` (Competition), `keyword_length` (Keyword length).
- Sort order (`sort_order`, text): Highest or lowest first. Defaults to highest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The ranking keywords
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "concurrency": 100,
      "cost": 1.1,
      "difficulty": 58,
      "domain": "example.com",
      "found_results": 870000000,
      "intents": [
        "commercial"
      ],
      "keyword": "running shoes",
      "keyword_length": 2,
      "position": 3,
      "region_queries_count": 110000,
      "subdomain": "www.example.com",
      "traff": 5400,
      "types": [
        "pic"
      ],
      "url": "https://www.example.com/running-shoes"
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Get domain overview

Get visibility, ranking keywords, estimated traffic and their changes for up to 10 domains at once.

**Inputs**

- Domains (`domains`, list, required): The domains to look up, up to 10, such as example.com.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.

**Outputs**

- `data` (list): One overview per domain
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "ad_keywords": 1200,
      "ads": 3400,
      "domain": "example.com",
      "down_keywords": 6100,
      "keywords": 250000,
      "keywords_dynamic": 3200,
      "new_keywords": 5100,
      "out_keywords": 1900,
      "prev_date": "2026-10-15",
      "rised_keywords": 8000,
      "traff": 1800000,
      "traff_dynamic": 21000,
      "visible": 12.5,
      "visible_dynamic": 0.4
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Get domain top pages

List a domain's pages by how many keywords each ranks for. Each page returned costs a credit.

**Inputs**

- Domain (`domain`, text, required): The domain whose pages to list.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Address contains (`url_contains`, text): Only pages whose address contains this text, such as /blog/.
- Sort order (`sort_order`, text): Most or fewest keywords first. Defaults to most first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The pages
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "keywords": 950,
      "url": "https://www.example.com/running-shoes"
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Get keyword metrics

Get search volume, cost per click, competition, difficulty and search features for a list of up to 1,000 keywords. Each keyword costs a credit.

**Inputs**

- Keywords (`keywords`, list, required): The keywords to look up, up to 1,000.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Include search intent (`include_intents`, true/false): Add each keyword's search intent (informational, navigational, commercial or transactional).

**Outputs**

- `data` (list): The keywords' metrics
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "concurrency": 100,
      "cost": 1.25,
      "difficulty": 62,
      "found_results": 512000000,
      "intents": [
        "commercial"
      ],
      "keyword": "best running shoes",
      "keyword_length": 3,
      "keywords_count": 5400,
      "lang": "en",
      "region_queries_count": 74000,
      "region_queries_count_wide": 90500,
      "suggestions_count": 1200,
      "types": [
        "pic",
        "video"
      ]
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Get keyword suggestions

Get the search suggestions (autocomplete phrases) people see for a keyword, useful for long-tail ideas. Each suggestion costs a credit.

**Inputs**

- Keyword (`keyword`, text, required): The keyword to get suggestions for.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Leave out keywords containing (`minus_keywords`, list): Words or phrases; keywords containing any of them are left out (up to 50).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The suggestions
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "geo_names": [],
      "keyword": "running shoes for women"
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Get lost backlinks

List the backlinks a domain or page has lost, with the linking page, anchor text and the date each was lost. Each link returned costs a credit.

**Inputs**

- Domain or URL (`target`, text, required): The domain, or the page's address, whose backlinks to read.
- Look at (`search_type`, text): What the domain or URL covers. Defaults to the domain alone. One of: `domain` (This domain only), `domain_with_subdomains` (Domain and its subdomains), `url` (This exact URL), `part_url` (URLs starting with this address). Default: `domain`.
- Sort by (`sort_by`, text): What to sort the results by. Leave empty for Serpstat's order. One of: `date_del` (Date lost), `check` (Date last checked), `url_from` (Linking page), `url_to` (Linked page), `anchor` (Anchor text), `links_external` (Outgoing links on the page).
- Sort order (`sort_order`, text): Highest or lowest first. Defaults to highest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The lost backlinks
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "anchor": "Example",
      "check": "2026-11-03",
      "date_add": "2025-03-01",
      "date_del": "2026-11-02",
      "domain_rank": 40,
      "link_external": "1",
      "link_nofollow": "follow",
      "link_type": "href",
      "url_from": "https://news.example.net/article",
      "url_to": "https://example.com/"
    }
  ],
  "summary_info": {
    "count": 1,
    "left_lines": 99950,
    "order": "desc",
    "page": 1,
    "sort": "check",
    "total": 1
  }
}
```

### Get page keywords

List the keywords one page ranks for in the top 100, with position, traffic, search volume and difficulty. Each keyword returned costs a credit.

**Inputs**

- Page address (`url`, text, required): The full address of the page, such as https://example.com/blog/post.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Include search intent (`include_intents`, true/false): Add each keyword's search intent (informational, navigational, commercial or transactional).
- Keyword contains (`keyword_contains`, text): Only keywords containing this text.
- Worst position (`position_to`, number): Only keywords ranking at this position or better (1 to 100). From 1 to 100.
- Sort by (`sort_by`, text): What to sort the results by. Leave empty for Serpstat's order. One of: `position`, `traff` (Traffic), `cost` (Cost per click), `difficulty` (Keyword difficulty).
- Sort order (`sort_order`, text): Highest or lowest first. Defaults to highest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The ranking keywords
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "concurrency": 100,
      "cost": 1.1,
      "difficulty": 58,
      "domain": "example.com",
      "found_results": 870000000,
      "intents": [
        "commercial"
      ],
      "keyword": "running shoes",
      "keyword_length": 2,
      "position": 3,
      "region_queries_count": 110000,
      "subdomain": "www.example.com",
      "traff": 5400,
      "types": [
        "pic"
      ],
      "url": "https://www.example.com/running-shoes"
    }
  ],
  "summary_info": {
    "left_lines": 99950,
    "page": 1,
    "total": 1
  }
}
```

### Get rank tracker positions

Get where the project's site ranked for each tracked keyword, day by day, in one region, optionally for a date range or another domain.

**Inputs**

- Rank tracker project (`project_id`, text, required): The project whose rank tracker to read. Pick one, or give its id from an earlier step.
- Region (`region_id`, text, required): The tracked region. Pick one, or give its id from 'List rank tracker regions'.
- From (`date_from`, date): Only positions on or after this date.
- Until (`date_to`, date): Only positions on or before this date.
- Keywords (`keywords`, list): Only these tracked keywords. Leave empty for all.
- Domain (`domain`, text): Another domain's positions, such as a competitor's. Leave empty for the project's own site.
- Include tags (`include_tags`, true/false): Add the tags each keyword has in the rank tracker.
- Sort by (`sort_by`, text): Sort by keyword or date. One of: `keyword`, `date`.
- Sort order (`sort_order`, text): Highest or lowest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`page_size`, text): How many to return. Defaults to 20. One of: `20` (20 (default)), `50`, `100`, `500`. Default: `20`.

**Outputs**

- `data` (object): The project, region and each keyword's positions
- `spent_limits` (number): Credits spent
- `summary_info` (object): The page

**Example output**

```json
{
  "data": {
    "domain": "example.com",
    "keywords": [
      {
        "expectedUrl": "https://www.example.com/running-shoes",
        "frequency": 110000,
        "history": [
          {
            "date": "2026-11-10",
            "positions": [
              {
                "position": 3,
                "url": "https://www.example.com/running-shoes"
              }
            ]
          }
        ],
        "keyword": "running shoes",
        "tags": []
      }
    ],
    "projectId": 1234567,
    "projectRegionId": 98765
  },
  "spent_limits": 1,
  "summary_info": {
    "count": 1,
    "page": 1,
    "page_total": 1,
    "total": 1
  }
}
```

### Get referring domains

List the domains that link to a domain, with how many links each gives and its domain rank. Each domain returned costs a credit.

**Inputs**

- Domain (`domain`, text, required): The domain whose referring domains to list.
- Include subdomains (`search_type`, text): The domain alone, or with its subdomains. Defaults to the domain alone. One of: `domain` (This domain only), `domain_with_subdomains` (Domain and its subdomains). Default: `domain`.
- Sort by (`sort_by`, text): What to sort the results by. Leave empty for Serpstat's order. One of: `domain_links` (Number of links), `domain_rank` (Domain rank), `check` (Date found), `domain_from` (Domain (A to Z)).
- Sort order (`sort_order`, text): Highest or lowest first. Defaults to highest first. One of: `desc` (Highest first), `asc` (Lowest first).
- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, number): How many to return, 1 to 1,000. Each one costs a credit. Serpstat's default is 100. From 1 to 1000.

**Outputs**

- `data` (list): The referring domains
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "domain_from": "blog.example.org",
      "domain_links": 14,
      "domain_rank": 54,
      "ref_pages": "14"
    }
  ],
  "summary_info": {
    "count": 1,
    "left_lines": 99950,
    "order": "desc",
    "page": 1,
    "sort": "check",
    "total": 1
  }
}
```

### Get search results for keyword

See who ranks for a keyword: the top search results in order, with each page's domain and its visibility, keyword counts and backlinks.

**Inputs**

- Keyword (`keyword`, text, required): The keyword whose search results to read.
- Search engine database (`se`, text): Which country's Google results (or Bing United States) to read. Defaults to Google United States. One of: `g_af` (Google Afghanistan (g_af)), `g_al` (Google Albania (g_al)), `g_dz` (Google Algeria (g_dz)), `g_ad` (Google Andorra (g_ad)), `g_ao` (Google Angola (g_ao)), `g_ai` (Google Anguilla (g_ai)), `g_ag` (Google Antigua & Barbuda (g_ag)), `g_ar` (Google Argentina (g_ar)), `g_am` (Google Armenia (g_am)), `g_aw` (Google Aruba (g_aw)), and 222 more. Default: `g_us`.
- Number of results (`size`, number): How many results to return, 10 to 100. Defaults to 100. From 10 to 100.

**Outputs**

- `summary_info` (object): The keyword's own metrics
- `top` (list): The results, in order

**Example output**

```json
{
  "summary_info": {
    "concurrency": 100,
    "cost": 1.1,
    "count_top_results": 100,
    "difficulty": 58,
    "frequency": 110000,
    "keyword": "running shoes",
    "left_limits": 99850,
    "se": "g_us",
    "types": [
      "pic"
    ]
  },
  "top": [
    {
      "domain": "example.com",
      "domain_in_domains_count": 25000,
      "domain_in_urls_count": 900000,
      "domain_keywords_organic": 250000,
      "domain_keywords_ppc": 1200,
      "domain_out_domains_count": 800,
      "domain_out_urls_count": 4000,
      "domain_sdr": 71,
      "domain_top_10_keywords_count": 18000,
      "domain_visibility": 12.5,
      "position": 1,
      "url": "https://www.example.com/running-shoes",
      "url_keywords_count": 950
    }
  ]
}
```

### List projects

List the projects in your Serpstat account with their domains and ids.

**Inputs**

- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`size`, text): How many to return. Defaults to 20. One of: `20` (20 (default)), `50`, `100`, `200`, `500`. Default: `20`.

**Outputs**

- `data` (list): The projects
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "created_at": "2026-01-15 10:00:00",
      "domain": "example.com",
      "group": "Default",
      "project_id": "1234567",
      "project_name": "Example",
      "type": "own"
    }
  ],
  "summary_info": {
    "count": 1,
    "page": 1,
    "page_total": 1,
    "total": 1
  }
}
```

### List rank tracker projects

List the projects that have Serpstat's rank tracker set up, with their domains, ids and whether tracking is on.

**Inputs**

- Page (`page`, number): Which page of results to get, starting at 1. At least 1.
- Results per page (`page_size`, text): How many to return. Defaults to 20. One of: `20` (20 (default)), `50`, `100`, `500`. Default: `20`.

**Outputs**

- `data` (list): The rank tracker projects
- `summary_info` (object): The page, the total and the credits left

**Example output**

```json
{
  "data": [
    {
      "createdAt": "2026-01-15 10:00:00",
      "domain": "example.com",
      "enableTracking": true,
      "group": "Default",
      "id": "1234567",
      "projectName": "Example",
      "status": 1,
      "type": "own"
    }
  ],
  "summary_info": {
    "count": 1,
    "page": 1,
    "page_total": 1,
    "total": 1
  }
}
```

### List rank tracker regions

List the regions a rank tracker project tracks: each search engine, country or city, and device, with the region id positions are read by.

**Inputs**

- Rank tracker project (`project_id`, text, required): The project whose rank tracker to read. Pick one, or give its id from an earlier step.

**Outputs**

- `projectId` (number): The project
- `regions` (list): The regions
- `spent_limits` (number): Credits spent

**Example output**

```json
{
  "projectId": 1234567,
  "regions": [
    {
      "active": true,
      "city": "",
      "country": "United States",
      "deviceType": "desktop",
      "id": 98765,
      "langCode": "en",
      "region": "United States",
      "searchEngine": "Google",
      "serpType": "organic"
    }
  ],
  "spent_limits": 0
}
```

### List site audits

List a project's site audit reports, newest first, with the site health score (0 to 100), pages scanned, critical and other issues, and progress.

**Inputs**

- Project (`project_id`, text, required): The Serpstat project. Pick one, or give its id from an earlier step.
- Number of reports (`limit`, number): How many reports to return. Serpstat's default is 30. From 1 to 1000.
- Skip (`offset`, number): How many of the newest reports to skip first. At least 0.

**Outputs**

- `count` (number): How many reports came back
- `reports` (list): The audit reports

**Example output**

```json
{
  "count": 1,
  "reports": [
    {
      "criticalCount": 3,
      "date": "2026-11-01 08:00:00",
      "hasDetailData": true,
      "nonCriticalCount": 41,
      "pagesLimit": 1000,
      "pagesScanned": 412,
      "progress": 100,
      "reportId": 555001,
      "sdo": 87,
      "stoped": false,
      "virusesCount": 0
    }
  ]
}
```
