> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ar/docs/products/domain-suggestions

# API الخاص بـ اقتراحات المجالات

احصل على اقتراحات أسماء مجالات مدعومة بالذكاء الاصطناعي بناءً على كلماتك الرئيسية أو علامتك التجارية أو وصف عملك. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.

[عرض صفحة المنتج](https://domscan.net/ar/domain-suggestions)

## العمليات

GET `/v1/suggest` [عرض مرجع API](https://domscan.net/ar/docs/products/domain-suggestions#suggestDomains)

## GET `/v1/suggest`

العملية: `suggestDomains`
الوحدات والمصادقة: 2-5
المصادقة مطلوبة

GET /v1/suggest الرصيد: 2-5

#### معاملات الاستعلام

| المعامل | النوع | مطلوب |
| --- | --- | --- |
| keywords | string | مطلوب |
| tlds | string | اختياري |
| style | string القيم المسموحة `brandable`, `keyword-rich`, `short`, `pronounceable`, `techy`, `playful`, `professional`, `minimal` الافتراضي `brandable` | اختياري |
| industry | string القيم المسموحة `tech`, `finance`, `health`, `ecommerce`, `education`, `media`, `saas`, `crypto`, `ai`, `gaming` | اختياري |
| language | string القيم المسموحة `en`, `zh`, `es`, `ja`, `de`, `fr`, `pt`, `it`, `ko`, `ru`, `ar`, `hi`, `bn`, `id`, `ms`, `th`, `vi`, `tr`, `pl`, `nl`, `sv`, `da`, `no`, `fi`, `el`, `cs`, `hu`, `ro`, `uk`, `he` الافتراضي `en` | اختياري |
| limit | integer الافتراضي `20` | اختياري |
| check | boolean الافتراضي `true` | اختياري |

#### حقول الرد

| الحقل | النوع |
| --- | --- |
| `suggestions[]` | object[] |
| `suggestions[]` | object |
| `suggestions[].name` | string |
| `suggestions[].domain` | string |
| `suggestions[].tld` | string |
| `suggestions[].score` | integer |
| `suggestions[].available` | boolean \| null |
| `suggestions[].method` | string |
| `suggestions[].styles[]` | string[] |
| `suggestions[].checked_at` | string |
| `keywords[]` | string[] |
| `tlds[]` | string[] |
| `styles[]` | string[] |
| `industry` | string \| null |
| `language` | string |
| `generated_count` | integer |
| `available_count` | integer \| null |
| `generation_summary` | object |
| `generation_summary.requested_limit` | integer |
| `generation_summary.candidate_count` | integer |
| `generation_summary.returned_count` | integer |
| `generation_summary.availability_checked` | boolean |
| `generation_summary.availability_check_count` | integer |
| `generation_summary.available_count` | integer \| null |
| `generation_summary.tld_count` | integer |
| `generation_summary.language` | string |
| `generation_summary.method_counts` | object |
| `generation_summary.style_counts` | object |
| `generation_summary.top_method` | string \| null |
| `generation_summary.average_score` | integer \| null |
| `meta` | object |
| `meta.total_generated` | integer |
| `meta.available_count` | integer |
| `meta.generation_ms` | integer |
| `meta.availability_check_ms` | integer |
| `meta.total_ms` | integer |
| `meta.served_by` | string |

#### طلب مثال

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true"
```

```javascript
const response = await fetch("https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
```

#### مثال الرد

```json
{
  "suggestions": [
    {
      "name": "brandpilot",
      "domain": "brandpilot.io",
      "tld": "io",
      "score": 86,
      "available": true,
      "method": "combination"
    },
    {
      "name": "getbrand",
      "domain": "getbrand.com",
      "tld": "com",
      "score": 78,
      "available": false,
      "method": "prefix"
    },
    {
      "name": "pilotbrand",
      "domain": "pilotbrand.ai",
      "tld": "ai",
      "score": 74,
      "available": null,
      "method": "combination"
    }
  ],
  "keywords": [
    "brand",
    "pilot"
  ],
  "tlds": [
    "com",
    "io",
    "ai"
  ],
  "styles": [
    "brandable",
    "keyword-rich",
    "short",
    "pronounceable"
  ],
  "language": "en",
  "generated_count": 12,
  "available_count": 4,
  "generation_summary": {
    "requested_limit": 3,
    "candidate_count": 12,
    "returned_count": 3,
    "availability_checked": true,
    "availability_check_count": 9,
    "available_count": 4,
    "tld_count": 3,
    "language": "en",
    "method_counts": {
      "combination": 2,
      "prefix": 1
    },
    "style_counts": {
      "brandable": 2,
      "keyword-rich": 2,
      "pronounceable": 1
    },
    "top_method": "combination",
    "average_score": 79
  },
  "meta": {
    "generation_ms": 6
  }
}
```

#### رموز حالة HTTP

- `200` OK
- `401` غير مصرح
- `402` الدفع مطلوب
- `429` طلبات كثيرة جداً

## موارد المرجع

[OpenAPI 3.0](https://domscan.net/v1/openapi.json)
[Postman](https://domscan.net/v1/postman.json)
[MCP](https://domscan.net/ar/mcp-domain-checker)
