--- title: "Get Google Finance Markets Advanced Results by id" url: "https://docs.dataforseo.com/v3/serp/google/finance_markets/task_get/advanced/" date: "2026-06-06" --- ## Get Google Finance Markets Advanced Results by id Google Finance Markets API provides real-time data from the ‘Markets’ tab of Google Finance. These results are specific to the parameters you specify in the request: ticker in the `keyword` field, `location` and `language`. ![checked](https://docs.dataforseo.com/v3/wp-content/themes/dataforseo/assets/img/icons/checked-circle.svg) GET https://api.dataforseo.com/v3/serp/google/finance\_markets/task\_get/advanced/$id Pricing Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free. The cost can be calculated on the [Pricing](https://dataforseo.com/pricing/serp/google-finance-serp-api "Pricing") page. **Description of the fields for sending a request:** | Field name | Type | Description | |---|---|---| | `id` | string | *task identifier* **unique task identifier in our system in the [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format** you will be able to use it within **30 days** to request the results of the task at any time | As a response of the API server, you will receive [JSON](https://en.wikipedia.org/wiki/JSON)-encoded data containing a `tasks` array with the information specific to the set tasks. You can also get all available SERP features and possible extra elements by making a request to the following [Sandbox](https://docs.dataforseo.com/v3/appendix/sandbox.md) URL: `https://sandbox.dataforseo.com/v3/serp/google/ads_search/task_get/advanced/00000000-0000-0000-0000-000000000000` The response will include all available items in the Google Ads Advertisers SERP Advanced endpoint with the fields containing dummy data. You won’t be charged for using [Sandbox](https://docs.dataforseo.com/v3/appendix/sandbox.md) endpoints. **Description of the fields in the results array:** | Field name | Type | Description | |---|---|---| | `version` | string | *the current version of the API* | | `status_code` | integer | *general status code* you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) **Note:** we strongly recommend designing a necessary system for handling related exceptional or error conditions | | `status_message` | string | *general informational message* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md) | | `time` | string | *execution time, seconds* | | `cost` | float | *total tasks cost, USD* | | `tasks_count` | integer | *the number of tasks in the **`tasks`** array* | | `tasks_error` | integer | *the number of tasks in the **`tasks`** array returned with an error* | | **`tasks`** | array | *array of tasks* | | `id` | string | *task identifier* **unique task identifier in our system in the [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format** | | `status_code` | integer | *status code of the task* generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) | | `status_message` | string | *informational message of the task* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md) | | `time` | string | *execution time, seconds* | | `cost` | float | *cost of the task, USD* | | `result_count` | integer | *number of elements in the `result` array* | | `path` | array | *URL path* | | `data` | object | *contains the same parameters that you specified in the POST request* | | **`result`** | array | *array of results* | | `keyword` | string | *keyword received in a POST array* **the keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)** | | `type` | string | *search engine type* in this case, equals `finance_markets` | | `se_domain` | string | *search engine domain in a POST array* | | `location_code` | string | *location code in a POST array* | | `language_code` | string | *language code in a POST array* | | `check_url` | string | *direct URL to search engine results* you can use it to make sure that we provided accurate results | | `datetime` | string | *date and time when the result was received* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2019-11-15 12:57:46 +00:00` | | `spell` | object | *autocorrection of the search engine* if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection | | `refinement_chips` | object | *search refinement chips* in this case, the value will be `null` | | `item_types` | array | *types of search results in SERP* contains types of search results (`items`) found in SERP; possible item types: [`google_finance_hero_groups`](#google_finance_hero_groups), [`google_finance_explore_market_trends`](#google_finance_explore_market_trends), [`google_finance_news`](#google_finance_news), [`google_finance_interested`](#google_finance_interested), [`google_finance_people_also_search`](#google_finance_people_also_search) | | `se_results_count` | integer | *total number of results in SERP* | | `items_count` | integer | *the number of results returned in the **`items`** array* | | **`items`** | array | *elements of search results found in SERP* | | **google\_finance\_hero\_groups item in SERP** | | | | `type` | string | *type of element = **‘google\_finance\_hero\_groups’*** | | `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` | | `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP | | `markets` | array | *financial markets data* array of items containing market indexes and other financial information related to these indexes | | `market` | string | *financial market identifier* possible values: `US`, `Europe`, `Asia`, `Currencies`, `Crypto`, `Futures` | | `items` | array | *market indexes data* array of items containing market indexes data; possible `type` of items: `google_finance_asset_pair_element`, `google_finance_market_instrument_element`, `google_finance_market_index_element` | | `type` | string | *type of element = **‘google\_finance\_market\_index\_element’*** | | `ticker` | string | *ticker of the market index* example: `DAX` | | `market_identifier` | string | *market identifier* example: `INDEXDB` | | `index_value` | float | *value of the market index* numerical value of the index at a given `timestamp` | | `index_value_delta` | float | *change in value of the market index* change in the `index_value` at a given `timestamp` | | `identifier` | string | *identifier of the element* full identifier of the element that consists from `ticker` and `market_identifier` example: `PX1:INDEXDB` | | `displayed_name` | string | *name of the market index as displayed on Google Finance* example: `CAC 40` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* example: `Europe/Paris` | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_asset\_pair\_element’*** | | `base_symbol` | string | *identifier of the base asset in a pair* example: `EUR` | | `quote_symbol` | string | *identifier of the quote asset in a pair* example: `USD` | | `base_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `quote_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `price` | float | *value of the base asset compared to the quote asset* | | `price_delta` | float | *change in price* change in `price` at a given `timestamp` | | `identifier` | string | *finance pair identifier* example: `EUR-USD` | | `displayed_name` | string | *displayed name of the finance pair* example: `EUR / USD` | | `url` | string | *URL to finance pair on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value* | | `type` | string | *type of element = **‘google\_finance\_market\_instrument\_element’*** | | `ticker` | string | *ticker of the market index* example: `YMW00` | | `price` | float | *price of the market instrument* price of the market instrument at a given `timestamp` | | `price_delta` | float | *change in price of the market instrument* change in `price` at a given `timestamp` | | `price_currency` | string | *price currency* example: `USD` | | `identifier` | string | *full identifier of the market index* example: `YMW00:CBOT` | | `displayed_name` | string | *displayed name of the market index* example: `E-mini Dow ($5)` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | **google\_finance\_explore\_market\_trends item in SERP** | | | | `type` | string | *type of element = **‘google\_finance\_explore\_market\_trends’*** | | `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` | | `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP | | `title` | string | *title of the market trends element* example: `Europe, Middle East, and Africa` | | `sub_title` | string | *sub-title of the market trends element* | | `url` | string | *URL to the page of the market trends element on Google Finance* | | `items` | array | *market indexes related to the market trends element* possible `type` of items: `google_finance_asset_pair_element`, `google_finance_market_instrument_element`, `google_finance_market_index_element` | | `type` | string | *type of element = **‘google\_finance\_market\_index\_element’*** | | `ticker` | string | *ticker of the market index* example: `DAX` | | `market_identifier` | string | *market identifier* example: `INDEXDB` | | `index_value` | float | *value of the market index* numerical value of the index at a given `timestamp` | | `index_value_delta` | float | *change in value of the market index* change in the `index_value` at a given `timestamp` | | `identifier` | string | *identifier of the element* full identifier of the element that consists from `ticker` and `market_identifier` example: `PX1:INDEXDB` | | `displayed_name` | string | *name of the market index as displayed on Google Finance* example: `CAC 40` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* example: `Europe/Paris` | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_asset\_pair\_element’*** | | `base_symbol` | string | *identifier of the base asset in a pair* example: `EUR` | | `quote_symbol` | string | *identifier of the quote asset in a pair* example: `USD` | | `base_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `quote_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `price` | float | *value of the base asset compared to the quote asset* | | `price_delta` | float | *change in price* change in `price` at a given `timestamp` | | `identifier` | string | *finance pair identifier* example: `EUR-USD` | | `displayed_name` | string | *displayed name of the finance pair* example: `EUR / USD` | | `url` | string | *URL to finance pair on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value* | | `type` | string | *type of element = **‘google\_finance\_market\_instrument\_element’*** | | `ticker` | string | *ticker of the market index* example: `YMW00` | | `price` | float | *price of the market instrument* price of the market instrument at a given `timestamp` | | `price_delta` | float | *change in price of the market instrument* change in `price` at a given `timestamp` | | `price_currency` | string | *price currency* example: `USD` | | `identifier` | string | *full identifier of the market index* example: `YMW00:CBOT` | | `displayed_name` | string | *displayed name of the market index* example: `E-mini Dow ($5)` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | **google\_finance\_news item in SERP** | | | | `type` | string | *type of element = **‘google\_finance\_news’*** | | `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` | | `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP | | `title` | string | *title of the news element* example: `In the news` | | `sub_title` | string | *sub-title of the news element* example: `Based on Europe, Middle East, and Africa` | | `items` | array | *google finance news articles* | | `type` | string | *type of element = **‘google\_finance\_news\_element’*** | | `title` | string | *title of the news article* | | `url` | string | *URL of the news article* | | `source` | string | *name of the news source* name of the website where the news article is published | | `image_url` | string | *featured image URL* URL of the news article’s featured image | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `quotes` | array | *market indexes quoted in the news article* information about market indexes quoted in the `google_finance_news_element` | | `type` | string | *type of element = **‘google\_finance\_market\_index\_element’*** | | `ticker` | string | *ticker of the market index* example: `DAX` | | `market_identifier` | string | *market identifier* example: `INDEXDB` | | `index_value` | float | *value of the market index* numerical value of the index at a given `timestamp` | | `index_value_delta` | float | *change in value of the market index* change in the `index_value` at a given `timestamp` | | `identifier` | string | *identifier of the element* full identifier of the element that consists from `ticker` and `market_identifier` example: `PX1:INDEXDB` | | `displayed_name` | string | *name of the market index as displayed on Google Finance* example: `CAC 40` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* example: `Europe/Paris` | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_market\_instrument\_element’*** | | `ticker` | string | *ticker of the market index* example: `YMW00` | | `price` | float | *price of the market instrument* price of the market instrument at a given `timestamp` | | `price_delta` | float | *change in price of the market instrument* change in `price` at a given `timestamp` | | `price_currency` | string | *price currency* example: `USD` | | `identifier` | string | *full identifier of the market index* example: `YMW00:CBOT` | | `displayed_name` | string | *displayed name of the market index* example: `E-mini Dow ($5)` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_asset\_pair\_element’*** | | `base_symbol` | string | *identifier of the base asset in a pair* example: `EUR` | | `quote_symbol` | string | *identifier of the quote asset in a pair* example: `USD` | | `base_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `quote_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `price` | float | *value of the base asset compared to the quote asset* | | `price_delta` | float | *change in price* change in `price` at a given `timestamp` | | `identifier` | string | *finance pair identifier* example: `EUR-USD` | | `displayed_name` | string | *displayed name of the finance pair* example: `EUR / USD` | | `url` | string | *URL to finance pair on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value* | | **google\_finance\_interested item in SERP** | | | | `type` | string | *type of element = **‘google\_finance\_interested’*** list of market indexes generated from recent searches, followed securities, and other activity | | `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` | | `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP | | `items` | array | *market indexes related to the market trends element* possible `type` of items: `google_finance_asset_pair_element`, `google_finance_market_instrument_element`, `google_finance_market_index_element` | | `type` | string | *type of element = **‘google\_finance\_market\_index\_element’*** | | `ticker` | string | *ticker of the market index* example: `DAX` | | `market_identifier` | string | *market identifier* example: `INDEXDB` | | `index_value` | float | *value of the market index* numerical value of the index at a given `timestamp` | | `index_value_delta` | float | *change in value of the market index* change in the `index_value` at a given `timestamp` | | `identifier` | string | *identifier of the element* full identifier of the element that consists from `ticker` and `market_identifier` example: `PX1:INDEXDB` | | `displayed_name` | string | *name of the market index as displayed on Google Finance* example: `CAC 40` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* example: `Europe/Paris` | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_market\_instrument\_element’*** | | `ticker` | string | *ticker of the market index* example: `YMW00` | | `price` | float | *price of the market instrument* price of the market instrument at a given `timestamp` | | `price_delta` | float | *change in price of the market instrument* change in `price` at a given `timestamp` | | `price_currency` | string | *price currency* example: `USD` | | `identifier` | string | *full identifier of the market index* example: `YMW00:CBOT` | | `displayed_name` | string | *displayed name of the market index* example: `E-mini Dow ($5)` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_asset\_pair\_element’*** | | `base_symbol` | string | *identifier of the base asset in a pair* example: `EUR` | | `quote_symbol` | string | *identifier of the quote asset in a pair* example: `USD` | | `base_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `quote_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `price` | float | *value of the base asset compared to the quote asset* | | `price_delta` | float | *change in price* change in `price` at a given `timestamp` | | `identifier` | string | *finance pair identifier* example: `EUR-USD` | | `displayed_name` | string | *displayed name of the finance pair* example: `EUR / USD` | | `url` | string | *URL to finance pair on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value* | | **google\_finance\_people\_also\_search item in SERP** | | | | `type` | string | *type of element = **‘google\_finance\_people\_also\_search’*** | | `items` | array | *market indexes related to the market trends element* possible `type` of items: `google_finance_asset_pair_element`, `google_finance_market_instrument_element`, `google_finance_market_index_element` | | `type` | string | *type of element = **‘google\_finance\_market\_index\_element’*** | | `ticker` | string | *ticker of the market index* example: `DAX` | | `market_identifier` | string | *market identifier* example: `INDEXDB` | | `index_value` | float | *value of the market index* numerical value of the index at a given `timestamp` | | `index_value_delta` | float | *change in value of the market index* change in the `index_value` at a given `timestamp` | | `identifier` | string | *identifier of the element* full identifier of the element that consists from `ticker` and `market_identifier` example: `PX1:INDEXDB` | | `displayed_name` | string | *name of the market index as displayed on Google Finance* example: `CAC 40` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* example: `Europe/Paris` | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_market\_instrument\_element’*** | | `ticker` | string | *ticker of the market index* example: `YMW00` | | `price` | float | *price of the market instrument* price of the market instrument at a given `timestamp` | | `price_delta` | float | *change in price of the market instrument* change in `price` at a given `timestamp` | | `price_currency` | string | *price currency* example: `USD` | | `identifier` | string | *full identifier of the market index* example: `YMW00:CBOT` | | `displayed_name` | string | *displayed name of the market index* example: `E-mini Dow ($5)` | | `url` | string | *URL to the page of the market index on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value of the market index* | | `type` | string | *type of element = **‘google\_finance\_asset\_pair\_element’*** | | `base_symbol` | string | *identifier of the base asset in a pair* example: `EUR` | | `quote_symbol` | string | *identifier of the quote asset in a pair* example: `USD` | | `base_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `quote_display_name` | string | *full name of the base asset in a pair* example: `Euro` | | `price` | float | *value of the base asset compared to the quote asset* | | `price_delta` | float | *change in price* change in `price` at a given `timestamp` | | `identifier` | string | *finance pair identifier* example: `EUR-USD` | | `displayed_name` | string | *displayed name of the finance pair* example: `EUR / USD` | | `url` | string | *URL to finance pair on Google Finance* | | `location` | string | *location of the market index* | | `trend` | string | *growth trend of the market index* possible values: `up`, `down`, `stable` | | `timestamp` | string | *date and time of the value readout* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2025-02-10 09:40:00 +00:00` | | `percentage_delta` | float | *percentage of change in value* | > Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access ``` # Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access login="login" password="password" cred="$(printf ${login}:${password} | base64)" id="02261816-2027-0066-0000-c27d02864073" curl --location --request GET "https://api.dataforseo.com/v3/serp/google/finance_markets/task_get/advanced/${id}" --header "Authorization: Basic ${cred}" --header "Content-Type: application/json" --data-raw "" ``` ```php getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; exit(); } try { $result = array(); // #1 - using this method you can get a list of completed tasks // GET /v3/serp/google/finance_markets/tasks_ready // in addition to 'google' and 'finance_markets' you can also set other search engine and type parameters // the full list of possible parameters is available in documentation $tasks_ready = $client->get('/v3/serp/google/finance_markets/tasks_ready'); // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) { foreach ($tasks_ready['tasks'] as $task) { if (isset($task['result'])) { foreach ($task['result'] as $task_ready) { // #2 - using this method you can get results of each completed task // GET /v3/serp/google/finance_markets/task_get/advanced/$id if (isset($task_ready['endpoint_advanced'])) { $result[] = $client->get($task_ready['endpoint_advanced']); } // #3 - another way to get the task results by id // GET /v3/serp/google/finance_markets/task_get/advanced/$id /* if (isset($task_ready['id'])) { $result[] = $client->get('/v3/serp/google/finance_markets/task_get/advanced/' . $task_ready['id']); } */ } } } } print_r($result); // do something with result } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; } $client = null; ?> ``` ```js const task_id = '02231256-2604-0066-2000-57133b8fc54e'; const axios = require('axios'); axios({ method: 'get', url: 'https://api.dataforseo.com/v3/serp/google/finance_markets/task_get/advanced/' + task_id, auth: { username: 'login', password: 'password' }, headers: { 'content-type': 'application/json' } }).then(function (response) { var result = response['data']['tasks']; // Result data console.log(result); }).catch(function (error) { console.log(error); }); ``` ```python from client import RestClient # You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip client = RestClient("login", "password") # 1 - using this method you can get a list of completed tasks # GET /v3/serp/google/finance_markets/tasks_ready # in addition to 'google' and 'finance_markets' you can also set other search engine and type parameters # the full list of possible parameters is available in documentation response = client.get("/v3/serp/google/finance_markets/tasks_ready") # you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors if response['status_code'] == 20000: results = [] for task in response['tasks']: if (task['result'] and (len(task['result']) > 0)): for resultTaskInfo in task['result']: # 2 - using this method you can get results of each completed task # GET /v3/serp/google/finance_markets/task_get/advanced/$id if(resultTaskInfo['endpoint_advanced']): results.append(client.get(resultTaskInfo['endpoint_advanced'])) ''' # 3 - another way to get the task results by id # GET /v3/serp/google/finance_markets/task_get/advanced/$id if(resultTaskInfo['id']): results.append(client.get("/v3/serp/google/finance_markets/task_get/advanced/" + resultTaskInfo['id'])) ''' print(results) # do something with result else: print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"])) ``` ```csharp using Newtonsoft.Json; using System; using System.Collections.Generic; using System.Net.Http; using System.Net.Http.Headers; using System.Text; using System.Threading.Tasks; namespace DataForSeoDemos { public static partial class Demos { public static async Task serp_task_get() { var httpClient = new HttpClient { BaseAddress = new Uri("https://api.dataforseo.com/"), // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) } }; // #1 - using this method you can get a list of completed tasks // GET /v3/serp/google/finance_markets/tasks_ready // in addition to 'google' and 'finance_markets' you can also set other search engine and type parameters // the full list of possible parameters is available in documentation var response = await httpClient.GetAsync("/v3/serp/google/finance_markets/tasks_ready"); var tasksInfo = JsonConvert.DeserializeObject(await response.Content.ReadAsStringAsync()); var tasksResponses = new List(); // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors if (tasksInfo.status_code == 20000) { if (tasksInfo.tasks != null) { foreach (var tasks in tasksInfo.tasks) { if (tasks.result != null) { foreach (var task in tasks.result) { if (task.endpoint_advanced != null) { // #2 - using this method you can get results of each completed task // GET /v3/serp/google/finance_markets/task_get/advanced/$id var taskGetResponse = await httpClient.GetAsync((string)task.endpoint_advanced); var taskResultObj = JsonConvert.DeserializeObject(await taskGetResponse.Content.ReadAsStringAsync()); if (taskResultObj.tasks != null) { var fst = taskResultObj.tasks.First; // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors if (fst.status_code >= 40000 || fst.result == null) Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}"); else tasksResponses.Add(fst.result); } // #3 - another way to get the task results by id // GET /v3/serp/google/finance_markets/task_get/advanced/$id /* var tasksGetResponse = await httpClient.GetAsync("/v3/serp/google/finance_markets/task_get/advanced/" + (string)task.id); var tasksResultObj = JsonConvert.DeserializeObject(await tasksGetResponse.Content.ReadAsStringAsync()); if (tasksResultObj.tasks != null) { var fst = taskResultObj.tasks.First; // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors if (fst.status_code >= 40000 || fst.result == null) Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}"); else tasksResponses.Add(fst.result); } */ } } } } } if (tasksResponses.Count > 0) // do something with result Console.WriteLine(String.Join(Environment.NewLine, tasksResponses)); else Console.WriteLine("No completed tasks"); } else Console.WriteLine($"error. Code: {tasksInfo.status_code} Message: {tasksInfo.status_message}"); } } } ``` > The above command returns JSON structured like this: ``` { "version": "0.1.20241227", "status_code": 20000, "status_message": "Ok.", "time": "0.1027 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "02171923-1535-0066-0000-59913d990e53", "status_code": 20000, "status_message": "Ok.", "time": "0.0327 sec.", "cost": 0, "result_count": 1, "path": [ "v3", "serp", "google", "finance_markets", "task_get", "advanced", "02171923-1535-0066-0000-59913d990e53" ], "data": { "api": "serp", "function": "task_get", "se": "google", "se_type": "finance_markets", "language_name": "English", "location_code": 2840, "keyword": "NASDAQ-100", "market_filter": "most-active", "priority": 2, "device": "desktop", "os": "windows" }, "result": [ { "keyword": "NASDAQ-100", "type": "finance_markets", "se_domain": "google.com", "location_code": 2840, "language_code": "en", "check_url": "https://www.google.com/finance/markets/most-active?hl=en&gl=us", "datetime": "2025-02-07 14:12:09 +00:00", "spell": null, "refinement_chips": null, "item_types": [ "google_finance_hero_groups", "google_finance_explore_market_trends", "google_finance_news", "google_finance_interested", "google_finance_people_also_search" ], "se_results_count": 0, "items_count": 4, "items": [ { "type": "google_finance_hero_groups", "rank_group": 1, "rank_absolute": 1, "markets": [ { "market": "Futures", "items": [ { "type": "google_finance_market_instrument_element", "ticker": "YMW00", "price": 44899, "price_delta": 36, "price_currency": "USD", "identifier": "YMW00:CBOT", "displayed_name": "E-mini Dow ($5)", "url": "https://google.com/finance/quote/YMW00:CBOT?hl=en&gl=us", "location": null, "trend": "up", "timestamp": "2025-02-07 14:01:43 +00:00", "percentage_delta": 0.0802443 }, { "market": "US", "items": [ { "type": "google_finance_market_index_element", "ticker": "VIX", "market_identifier": "INDEXCBOE", "index_value": 15.05, "index_value_delta": -0.4499998, "identifier": "VIX:INDEXCBOE", "displayed_name": "VIX", "url": "https://google.com/finance/quote/VIX:INDEXCBOE?hl=en&gl=us", "location": "America/Chicago", "trend": "down", "timestamp": "2025-02-07 13:56:46 +00:00", "percentage_delta": -2.9032245 } ] }, { "market": "Europe", "items": [ { "type": "google_finance_market_index_element", "ticker": "SX5E", "market_identifier": "INDEXSTOXX", "index_value": 5346.93, "index_value_delta": -9.699707, "identifier": "SX5E:INDEXSTOXX", "displayed_name": "EURO STOXX 50", "url": "https://google.com/finance/quote/SX5E:INDEXSTOXX?hl=en&gl=us", "location": "Europe/Berlin", "trend": "down", "timestamp": "2025-02-07 13:56:30 +00:00", "percentage_delta": -0.18107854 } ] }, { "market": "Asia", "items": [ { "type": "google_finance_market_index_element", "ticker": "NIFTY_50", "market_identifier": "INDEXNSE", "index_value": 23559.95, "index_value_delta": -43.40039, "identifier": "NIFTY_50:INDEXNSE", "displayed_name": "NIFTY 50", "url": "https://google.com/finance/quote/NIFTY_50:INDEXNSE?hl=en&gl=us", "location": "Asia/Calcutta", "trend": "down", "timestamp": "2025-02-07 10:01:10 +00:00", "percentage_delta": -0.18387386 } ] }, { "market": "Currencies", "items": [ { "type": "google_finance_asset_pair_element", "base_symbol": "AUD", "quote_symbol": "USD", "base_display_name": "Australian Dollar", "quote_display_name": "United States Dollar", "price": 0.6278299430000001, "price_delta": -0.00031005700000000003, "identifier": "AUD-USD", "displayed_name": "AUD / USD", "url": "https://google.com/finance/quote/AUD-USD?hl=en&gl=us", "location": null, "trend": "down", "timestamp": "2025-02-07 14:11:05 +00:00", "percentage_delta": -0.04936112 } ] }, { "market": "Crypto", "items": [ { "type": "google_finance_asset_pair_element", "base_symbol": "DOGE", "quote_symbol": "USD", "base_display_name": "Dogecoin", "quote_display_name": "United States Dollar", "price": 0.26068559999999996, "price_delta": 0.013041583079999999, "identifier": "DOGE-USD", "displayed_name": "Dogecoin (DOGE / USD)", "url": "https://google.com/finance/quote/DOGE-USD?hl=en&gl=us", "location": null, "trend": "up", "timestamp": "2025-02-07 14:09:46 +00:00", "percentage_delta": 5.266261999999999 } ] } ] }, { "type": "google_finance_explore_market_trends", "rank_group": 1, "rank_absolute": 2, "title": "Most active", "sub_title": "The stocks or funds with the highest trading volume (in shares) during the current trading session", "url": null, "items": [ { "type": "google_finance_market_instrument_element", "ticker": "TDOC", "price": 11.97, "price_delta": 0, "price_currency": "USD", "identifier": "TDOC:NYSE", "displayed_name": "Teladoc Health Inc", "url": "https://google.com/finance/quote/TDOC:NYSE?hl=en&gl=us", "location": "America/New_York", "trend": "stable", "timestamp": "2025-02-07 14:11:40 +00:00", "percentage_delta": 0 } ] }, { "type": "google_finance_news", "rank_group": 1, "rank_absolute": 3, "title": "In the news", "sub_title": "Based on most active", "items": [ { "type": "google_finance_news_element", "title": "This Could Be the Month That Makes or Breaks Super Micro Computer's Stock", "url": "https://www.fool.com/investing/2025/02/06/this-could-be-the-month-that-makes-or-breaks-super/", "source": "The Motley Fool", "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRtylMUOIZnbddlHj3uzxLIDum8Xy42B2uFRcOQv3xyq1bNo0XSu9XmLXjGr_s", "timestamp": "2025-02-06 14:27:00 +00:00", "quotes": [ { "type": "google_finance_market_instrument_element", "ticker": "SMCI", "price": 33.84, "price_delta": 0, "price_currency": "USD", "identifier": "SMCI:NASDAQ", "displayed_name": "Super Micro Computer Inc", "url": "https://google.com/finance/quote/SMCI:NASDAQ?hl=en&gl=us", "location": "America/New_York", "trend": "stable", "timestamp": "2025-02-07 14:11:56 +00:00", "percentage_delta": 0 } ] }, { "type": "google_finance_news_element", "title": "1 AI Stock to Buy Before It Soars 335% to $1 Trillion, According to a Wall nStreet Analyst", "url": "https://finance.yahoo.com/news/1-ai-stock-buy-soars-081000093.html", "source": "Yahoo Finance", "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRKC85EuzoaawfpMrY9qYJfX0e4gkZ3P22FIkUmzj_Ct6CSfwD02tZCK3zu4tA", "timestamp": "2025-02-07 08:10:00 +00:00", "quotes": [ { "type": "google_finance_market_instrument_element", "ticker": "PLTR", "price": 111.28, "price_delta": 0, "price_currency": "USD", "identifier": "PLTR:NASDAQ", "displayed_name": "Palantir Technologies Inc", "url": "https://google.com/finance/quote/PLTR:NASDAQ?hl=en&gl=us", "location": "America/New_York", "trend": "stable", "timestamp": "2025-02-07 14:11:55 +00:00", "percentage_delta": 0 } ] } ] }, { "type": "google_finance_interested", "rank_group": 1, "rank_absolute": 4, "items": [ { "type": "google_finance_market_index_element", "ticker": "COMPOSITE", "market_identifier": "IDX", "index_value": 6742.576, "index_value_delta": -132.95996, "identifier": "COMPOSITE:IDX", "displayed_name": "IDX Composite", "url": "https://google.com/finance/quote/COMPOSITE:IDX?hl=en&gl=us", "location": "Asia/Jakarta", "trend": "down", "timestamp": "2025-02-07 09:00:04 +00:00", "percentage_delta": -1.9338123 }, { "type": "google_finance_market_instrument_element", "ticker": "TLKM", "price": 2590, "price_delta": 30, "price_currency": "IDR", "identifier": "TLKM:IDX", "displayed_name": "Telkom Indonesia (Persero) Tbk PT", "url": "https://google.com/finance/quote/TLKM:IDX?hl=en&gl=us", "location": "Asia/Jakarta", "trend": "up", "timestamp": "2025-02-07 09:40:00 +00:00", "percentage_delta": 1.171875 } ] }, { "type": "google_finance_people_also_search_item", "items": [ { "type": "google_finance_market_instrument_element", "ticker": "AAPL", "market": "NASDAQ", "price": 222.64, "price_delta": -7.3399963, "price_currency": "USD", "identifier": "AAPL:NASDAQ", "display_name": "Apple Inc", "url": "https://google.com/finance/quote/AAPL:NASDAQ?hl=en&gl=de", "location": "America/New_York", "trend": "down", "timestamp": "2025-01-22T11:05:04Z", "percentage_delta": -3.1915803 } ] } ] } ] } ] } ] } ``` cURL php Node.js Python cSharp