---
title: "SEO helpers"
description: "Build popular landing pages and resolve brand/model URL slugs."
canonical: "https://thecarapi.com/docs/seo"
contract_version: "2026-08-19"
api_base: "https://api.thecarapi.com"
source: "https://thecarapi.com/docs/seo.md"
---

# SEO helpers

Build popular landing pages and resolve brand/model URL slugs.

## GET /api/seo/popular-searches

List the most common live brand/model searches.

**Scope:** `seo`

### Parameters

| Parameter | Send in | Type | Required | Example | Where the value comes from | Description |
| --- | --- | --- | --- | --- | --- | --- |
| `limit` | Query string | integer | no | `50` | Result count chosen by your application. | Number of results from 1 to 200. Default 20. |

### Example requests

```http
GET https://api.thecarapi.com/api/seo/popular-searches
```

```http
GET https://api.thecarapi.com/api/seo/popular-searches?limit=50
```

### Example response

```json
{
  "success": true,
  "results": [
    {
      "brand": "BMW",
      "model": "320d",
      "brand_slug": "bmw",
      "model_slug": "320d",
      "count": 210
    }
  ]
}
```

## GET /api/seo/brand-model-from-slug

Resolve brand and model slugs to their canonical display names.

**Scope:** `seo`

### Parameters

| Parameter | Send in | Type | Required | Example | Where the value comes from | Description |
| --- | --- | --- | --- | --- | --- | --- |
| `brand_slug` | Query string | string | yes | `bmw` | /api/seo/popular-searches -> results[].brand_slug | Brand slug, such as bmw. |
| `model_slug` | Query string | string | yes | `320d` | /api/seo/popular-searches -> results[].model_slug | Model slug, such as 320d. |

### Example requests

```http
GET https://api.thecarapi.com/api/seo/brand-model-from-slug?brand_slug=bmw&model_slug=320d
```

```http
GET https://api.thecarapi.com/api/seo/brand-model-from-slug?brand_slug=volvo&model_slug=xc60
```

### Example response

```json
{
  "success": true,
  "brand": "BMW",
  "model": "320d"
}
```

**Notes.** Returns 404 unless the slug pair identifies exactly one live brand/model combination.