# Check a competitor's organic traffic and top keywords

> Check any competitor's organic traffic estimate, ranking keywords, and top organic rivals with one API call or CLI command using seo.domain.

**To check a competitor's organic traffic and top ranking keywords, run `vibiz seo domain <domain>` or send a request to the `seo.domain` API action.** You receive an estimate of their monthly organic search visits, the estimated commercial value of that traffic, a list of their highest-traffic keywords with live SERP positions, and other domains competing for those exact search queries.

Understanding where a rival gets search traffic shapes your own content and search strategy. Instead of guessing which articles perform or paying for bulky software suites, you can query Google search data directly via the CLI, HTTP requests, or an AI agent workflow.

## How to pull competitor organic traffic data

You can run competitor lookups through the `vibiz` CLI or by calling the API directly.

### Using the CLI

Run `vibiz seo domain` followed by the competitor's domain name:

```bash
vibiz seo domain competitor.com --limit 20
```

You can target specific regions or languages by adding `--location` and `--language`:

```bash
vibiz seo domain competitor.com --location "United Kingdom" --language "en" --limit 50
```

### Using HTTP

Send a `POST` request to `/v1/actions/seo.domain` with the competitor's URL or bare domain:

```bash
curl https://thelastapi.dev/v1/actions/seo.domain \
  -H "Authorization: Bearer $VIBIZ_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "domain": "competitor.com",
      "location": "United States",
      "language": "en",
      "limit": 20
    }
  }'
```

Every action execution returns an `action_result` object containing the data payload, execution cost in `cost_micro_usd`, the unique `run_id`, and a `console_url` to view the run.

## What the domain analysis returns

The output of `seo.domain` breaks into three primary areas:

```json
{
  "domain": "competitor.com",
  "location": "United States",
  "language": "en",
  "organic": {
    "keywords": 1420,
    "traffic_estimate": 84200,
    "traffic_value_usd": 112000
  },
  "top_keywords": [
    {
      "keyword": "best analytics tool",
      "position": 2,
      "search_volume": 18100,
      "url": "https://competitor.com/blog/analytics-tools"
    }
  ],
  "competitors": [
    {
      "domain": "rival-platform.io",
      "common_keywords": 412,
      "traffic_estimate": 62000
    }
  ]
}
```

1. **`organic` summary**:
   - `keywords`: The total count of tracked terms where the competitor ranks in search results.
   - `traffic_estimate`: The estimated monthly visits coming from organic Google search.
   - `traffic_value_usd`: What that organic traffic would cost if purchased through paid search ads.
2. **`top_keywords`**: The specific terms driving the bulk of their organic visits. Each entry gives the target `keyword`, the competitor's search `position`, the average monthly `search_volume`, and the ranking `url`.
3. **`competitors`**: Related websites competing for overlapping search terms, including the volume of `common_keywords` and their own `traffic_estimate`.

## Analyzing the competitor's top pages

Once `seo.domain` hands you the ranking keywords and URLs, inspect the actual content your competitor used to secure those positions.

You can pull the clean text of their top ranking pages directly as markdown using the CLI:

```bash
vibiz scrape https://competitor.com/blog/analytics-tools
```

Or run an on-page technical check on that specific URL to see why Google favors it:

```bash
vibiz seo audit https://competitor.com/blog/analytics-tools
```

`seo.audit` loads the page and reports technical details such as `status_code`, `title`, `description`, `h1`, `word_count`, `load_time_ms`, overall `score`, and any on-page `issues`. For broader keyword discovery after finding their best content, see how to pair this with [a web search API for AI agents and apps](https://thelastapi.dev/blog/web-search-api-ai-agents) and our guide on how to [scrape a website to markdown with one API call](https://thelastapi.dev/blog/scrape-website-to-markdown-api).

## Running SEO actions from code or AI agents

If you are developing automated competitive research inside a Node.js or TypeScript application, invoke the action via `@vibiz/app`:

```ts
import { vibiz } from '@vibiz/app';

const { output } = await vibiz.actions.run('seo.domain', {
  domain: 'competitor.com',
  location: 'United States',
  limit: 25,
});

console.log('Estimated visits:', output.organic.traffic_estimate);
console.log('Traffic value ($):', output.organic.traffic_value_usd);

for (const item of output.top_keywords) {
  console.log(`${item.keyword} | Pos: ${item.position} | Vol: ${item.search_volume}`);
}
```

When building with AI agents (such as Claude Code, Cursor, or Cline), expose the action through the MCP tool `vibiz_seo`. Pass `{ action: "domain", input: { domain: "competitor.com" } }` to let your agent inspect rival search positions automatically during development or reporting tasks. If your agent needs to evaluate entire content libraries, consider how you can [crawl a whole site to markdown for RAG](https://thelastapi.dev/blog/crawl-site-markdown-rag).

## Comparing related SEO actions

`seo.domain` is one piece of a full SEO toolkit. Depending on whether you want broad domain estimates, specific SERP snapshots, backlink profiles, or search volumes, use the action fitted to the task:

| Action | CLI Command | What It Returns | Typical Cost |
| --- | --- | --- | --- |
| `seo.domain` | `vibiz seo domain <domain>` | Traffic estimates, top ranking keywords, organic rivals | 1–4 cents |
| `seo.serp` | `vibiz seo serp "<keyword>"` | Live SERP rankings, positions, SERP features | Fraction of a cent |
| `seo.keywords` | `vibiz seo keywords <k1,k2>` | Search volume, CPC, competition index (up to 1,000 terms) | ~8 cents / 1k batch |
| `seo.keyword_ideas` | `vibiz seo ideas "<keyword>"` | Related keyword expansions and search difficulty | 1–4 cents |
| `seo.backlinks` | `vibiz seo backlinks <domain>` | Referring domains, backlink counts, anchors | ~4 cents |
| `seo.audit` | `vibiz seo audit <url>` | On-page technical analysis, word count, load times | Fraction of a cent |
| `seo.ai_mentions` | `vibiz seo ai <domain>` | Brand citations inside ChatGPT and Google AI Overviews | ~2 cents / platform |

Detailed input schemas for all actions are documented under [Web data: scrape, search, SEO, ads library](https://thelastapi.dev/docs/actions).

## Inspecting previous runs and managing spend

Every data request executed by the CLI, code, or an AI agent is tracked and preserved.

To inspect past lookups from your terminal:

```bash
vibiz runs --action seo.domain --since 1d
```

To fetch the exact output payload of a previous run without incurring new action costs:

```bash
vibiz runs arun_1234567890
```

Action runs bill against your account credits based on the raw action cost (`cost_micro_usd`) plus a 30% margin. All web data calls count toward your account's daily spend ceiling ($5 per day by default, adjustable by the account owner in Billing).

## Next step

Run `vibiz seo domain competitor.com` to identify the keywords sending visits to your competitors, or check your own site setup in [Search](https://thelastapi.dev/docs/search) to automate indexation with Google and Bing.

## Frequently asked questions

### What location and language settings can I use with seo.domain?

You can pass a country name like `"United Kingdom"`, a two-letter country code like `"uk"` or `"de"`, or a specific city path like `"Austin,Texas,United States"`. Language accepts codes such as `"en"` or full names like `"English"`.

### What happens if I exceed the rate limit on SEO data requests?

If you exceed rate limits—such as the cap of about 12 calls per minute on `seo.keywords` or your account's daily spend ceiling—the API responds with HTTP status `429 rate_limited` and a `retry_after` duration in seconds.

### Can I check who links to my competitor's top-performing pages?

Yes. Pass the competitor's domain or a specific ranking URL to the `seo.backlinks` action (or run `vibiz seo backlinks competitor.com`) to retrieve their referring domains, dofollow links, anchor text, and spam scores.

---

Published 2026-11-15 · https://thelastapi.dev/blog/competitor-organic-traffic
