# الحصول على نتائج Google Finance Ticker Search حسب المعرّف

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/serp/google/finance_ticker_search/task_get/advanced/{id}`

**Tags:** DataForSEO

يسترجع نتيجة Google finance ticker search المصطفّة حسب `id`. يعيد `keyword` و`type` و`se_domain` و`location_code` و`language_code` و`check_url` و`datetime` و`spell` و`refinement_chips` و`item_types` و`items_count` و`items`. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في `tasks[0].result`، والنتيجة في `tasks[0].status_code` — ولا يزال الطلب المرفوض يعيد HTTP 200.

### مرجع التسعير

- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

## Related links

- [UUID](<https://en.wikipedia.org/wiki/Universally_unique_identifier>)

## Base URL

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

## Authentication

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

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string | <em>معرّف المهمة</em><br><strong>معرّف مهمة فريد في نظامنا بصيغة UUID</strong><br>يمكنك استخدامه خلال <strong>30 يومًا</strong> لطلب نتائج المهمة في أي وقت |

## Responses

### 200 — عملية ناجحة

Headers:
- `X-Request-Id` (string) — معرّف الطلب المراد تضمينه عند التواصل مع دعم Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedResponseInfo"
    }
  ]
}
```

### 400 — تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

### 401 — مطلوب مفتاح API صالح من Felo.

### 402 — لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

### 403 — الحساب غير مصرّح له بهذه العملية.

### 429 — تم بلوغ حد الطلبات أو حد الإنفاق.

### 502 — تعذّر على الخدمة إكمال الطلب.

### 503 — خدمة API أو الفوترة غير متاحة مؤقتًا.

### 504 — انتهت مهلة الخدمة أثناء معالجة الطلب.

### default — استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AmazonLabelElement

`#/components/schemas/Response36Afe1097B20_AmazonLabelElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "عنوان العنصر"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "عنوان URL للبحث مع معاملات التنقية"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "النطاق في SERP"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "الإصدار الحالي من API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز الحالة العام\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "رسالة معلوماتية عامة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "إجمالي وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "معرّف المهمة\nمعرّف مهمة فريد في نظامنا بصيغة UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز حالة المهمة\nينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "الرسالة المعلوماتية للمهمة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد العناصر في مصفوفة result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "مسار URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "يحتوي على المعاملات نفسها التي حددتها في طلب POST"
    }
  }
}
```

### Response36Afe1097B20_BaseSerpApiGoogleFinanceTickerSearchElementItem

`#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleFinanceTickerSearchElementItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>ترتيب المجموعة في SERP</em><br>الموضع ضمن مجموعة عناصر ذات قيم <code>type</code> متطابقة<br>تُستبعد مواضع العناصر ذات قيم <code>type</code> مختلفة من <code>rank_group</code>"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>الترتيب المطلق في SERP</em><br>الموضع المطلق بين جميع العناصر في SERP"
    },
    "identifier": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>معرّف العنصر</em><br>المعرّف الكامل للعنصر المكوّن من <code>ticker</code> و<code>market_identifier</code><br>مثال: <code>PX1:INDEXDB</code>"
    },
    "displayed_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>اسم مؤشر السوق كما يظهر في Google Finance</em><br>مثال: <code>CAC 40</code>"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL لصفحة مؤشر السوق على Google Finance</em>"
    },
    "location": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>موقع مؤشر السوق</em><br>مثال: <code>Europe/Paris</code>"
    },
    "trend": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>اتجاه نمو مؤشر السوق</em><br>القيم الممكنة: <code>up</code>، <code>down</code>، <code>stable</code>"
    },
    "timestamp": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>تاريخ ووقت قراءة القيمة</em><br>بتنسيق UTC: \"yyyy-mm-dd hh-mm-ss +00:00\"<br>مثال:<br><code class=\"long-string\">2025-02-10 09:40:00 +00:00</code>"
    },
    "percentage_delta": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>النسبة المئوية للتغير في قيمة مؤشر السوق</em>"
    }
  },
  "additionalProperties": false,
  "discriminator": {
    "propertyName": "type",
    "mapping": {
      "google_finance_asset_pair": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceAssetPairElementItem",
      "google_finance_market_instrument": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketInstrumentElementItem",
      "google_finance_market_index": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketIndexElementItem"
    }
  }
}
```

### Response36Afe1097B20_RefinementChipsElement

`#/components/schemas/Response36Afe1097B20_RefinementChipsElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "عنوان العنصر"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "عنوان URL للبحث مع معاملات التنقية"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "النطاق في SERP"
    },
    "options": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement"
          }
        ]
      },
      "description": "خيارات تحسين البحث الإضافية"
    }
  }
}
```

### Response36Afe1097B20_RefinementChipsInfo

`#/components/schemas/Response36Afe1097B20_RefinementChipsInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "xpath": {
      "type": [
        "string",
        "null"
      ],
      "description": "XPath الخاص بالعنصر"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement"
          }
        ]
      },
      "description": "العناصر التابعة للعنصر"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedTaskInfo"
              }
            ]
          },
          "description": "<em>مصفوفة المهام</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>الكلمة المفتاحية المستلمة في مصفوفة POST</em><br><strong>تُعاد الكلمة المفتاحية مع فك ترميز %## (سيُفكّ ترميز الرمز '+' إلى مسافة)</strong>"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>نطاق محرك البحث في مصفوفة POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>رمز الموقع في مصفوفة POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>رمز اللغة في مصفوفة POST</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL مباشر لنتائج محرك البحث</em><br>يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>التاريخ والوقت اللذان استُلمت فيهما النتيجة</em><br>بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>مثال:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "spell": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo"
        }
      ],
      "description": "<em>التصحيح التلقائي لمحرك البحث</em><br>إذا قدّم محرك البحث نتائج لكلمة مفتاحية صُحّحت، فسنحدد الكلمة المفتاحية التي صحّحها محرك البحث ونوع التصحيح التلقائي"
    },
    "refinement_chips": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo"
        }
      ],
      "description": "<em>شرائح تنقية البحث</em><br>في هذه الحالة، ستكون القيمة <code>null</code>"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>أنواع نتائج البحث في SERP</em><br>تحتوي على أنواع نتائج البحث (<code>items</code>) الموجودة في SERP؛<br>أنواع العناصر الممكنة: google_finance_market_index, google_finance_asset_pair, google_finance_market_instrument"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> العدد الإجمالي للنتائج في SERP</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>عدد النتائج المعادة في المصفوفة <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleFinanceTickerSearchElementItem"
          }
        ]
      },
      "description": "<em>عناصر نتائج البحث الموجودة في SERP</em><br>مصفوفة عناصر تحتوي على بيانات مؤشرات السوق؛<br>أنواع <code>type</code> الممكنة للعناصر: <code>google_finance_market_index</code>، <code>google_finance_asset_pair</code>، <code>google_finance_market_instrument</code>"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceTickerSearchTaskGetAdvancedResultInfo"
              }
            ]
          },
          "description": "<em>مصفوفة نتائج</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SpellInfo

`#/components/schemas/Response36Afe1097B20_SpellInfo`

```json
{
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "الكلمة المفتاحية التي تم الحصول عليها نتيجة التصحيح التلقائي لمحرك البحث\n ستُقدَّم النتائج للكلمة المفتاحية المصححة"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع التصحيح التلقائي\n القيم الممكنة:\n did_you_mean, showing_results_for, no_results_found_for, including_results_for\n ملاحظة: يدعم Yahoo وYandex نوع التصحيح التلقائي التالي فقط:\n including_results_for"
    }
  }
}
```
