# ویب تلاش چلائیں اور درجہ بند نتائج واپس کریں۔

**API:** Data API

**Endpoint:** `POST /v1/beta/firecrawl/search`

**Tags:** Firecrawl

ویب تلاش کریں اور درجہ بند نتائج واپس حاصل کریں۔ `query` درکار ہے؛ `limit` تعداد مقرر کرتا ہے۔ `success`، `creditsUsed`، ایک درخواست `id`، اور `data.web[]` واپس کرتا ہے جس میں `url`، `title`، `description` اور `position` ہوتے ہیں — **صرف عنوانات اور اسنپٹس، صفحے کا متن نہیں**۔ کسی اور چیز کی طرف جائیں جب: آپ کو اسی کال میں صفحے کا متن چاہیے — `searchWeb` وہ دیتا ہے اور ایک تہائی وقت میں جواب دیتا ہے؛ URLs آپ کو پہلے سے معلوم ہیں — `post_firecrawl_scrape`؛ آپ مطلوبہ الفاظ کے بجائے معنی سے مطابقت چاہتے ہیں — `post_exa_search`۔

### قیمت کا حوالہ

- میٹرنگ: میٹر شدہ نتائج کی تعداد۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.002142۔
- فی یونٹ لاگت کی بنیاد: USD 0.001071۔
- ریسورس یونٹ: `firecrawl_credit`۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
- لاگت کی بنادیں حتمی صارف قیمت کا تعین نہیں کرتیں، بشمول اس کے کہ صفر ہوں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "additionalProperties": false,
  "properties": {
    "enterprise": {
      "default": false,
      "enum": [
        false
      ],
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "maxLength": 2000,
      "minLength": 1,
      "type": "string"
    },
    "sources": {
      "default": [
        "web"
      ],
      "enum": [
        [
          "web"
        ]
      ],
      "items": {
        "type": "string"
      },
      "maxItems": 1,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
```

Example:

```json
{
  "enterprise": false,
  "limit": 10,
  "query": "nike",
  "sources": [
    "web"
  ]
}
```

## Responses

### 200 — تلاش کامیابی سے مکمل ہو گئی۔

Headers:
- `X-Request-Id` (string) — Felo سپورٹ سے رابطہ کرتے وقت شامل کرنے کے لیے درخواست کا شناخت کنندہ۔

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "true جب search کامیاب ہو۔"
    },
    "data": {
      "type": "object",
      "properties": {
        "web": {
          "type": "array",
          "description": "درجہ بند ویب سرچ نتائج۔",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "description": "نتیجے کا عنوان۔"
              },
              "url": {
                "type": "string",
                "description": "نتیجے کا URL۔"
              },
              "description": {
                "type": "string",
                "description": "نتیجے کا اسنیپٹ۔"
              }
            }
          }
        }
      }
    },
    "creditsUsed": {
      "type": "integer",
      "description": "استعمال شدہ Firecrawl کریڈٹس (تقریباً فی 10 نتائج 2)۔"
    }
  }
}
```

### 400 — درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔

### 401 — درست Felo API کلید درکار ہے۔

### 402 — درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

### 403 — اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

### 429 — درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

### 502 — سروس درخواست مکمل نہیں کر سکی۔

### 503 — API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

### 504 — درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

### default — خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

**application/json**

Schema:

```json
{}
```
