v0.2.0-beta

OpenAPI 3.1.0

Live Google Finance Ticker Search Advanced

Felo API Support

MIT

Server

https://openapi.felo.ai

Client Libraries

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operations

post/v1/beta/dataforseo/serp/google/finance_ticker_search/live/advanced

Live Google Finance Ticker Search Advanced

Returns tickers matching a query in Google Finance on Google, synchronously. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. advanced is the default choice; take regular when only the ranked list matters and html only to check what the parser dropped. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Pricing reference

Metering: Reported response cost.
Reference request estimate: USD 0.02.
Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

Body

application/json

Type: array (object | null)[]
- category
  Type: string | null
  
  category of financial instruments to search for
  
  optional field
  
  possible values: all, stock, index, mutual_fund, currency, futures
  
  default value: all
- keyword
  Type: string
  
  company or financial instrument name
  
  required field
  
  in this field, you can enter the name of a company or financial instrument to search for relevant tickers;
  
  you can specify up to 700 characters in the keyword field;
  
  all %## will be decoded (plus character ‘+’ will be decoded to a space character)
  
  if you need to use the “%” character for your keyword, please specify it as “%25”;
  
  if you need to use the “+” character for your keyword, please specify it as “%2B”;
  
  learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article
- language_code
  Type: string
  
  search engine language code
  
  required field if you don't specify language_name
  
  if you use this field, you don't need to specify language_name
  
  you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languages
  
  example:
  
  en
- language_name
  Type: string
  
  full name of search engine language
  
  required field if you don't specify language_code
  
  if you use this field, you don't need to specify language_code
  
  you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languages
  
  example:
  
  English
- location_code
  Type: integer
  
  search engine location code
  
  required field if you don't specify location_name
  
  if you use this field, you don't need to specify location_name
  
  you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations
  
  example:
  
  2840
- location_name
  Type: string
  
  full name of search engine location
  
  required field if you don't specify location_code
  
  if you use this field, you don't need to specify location_code
  
  you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locations
  
  example:
  
  London,England,United Kingdom
- tag
  Type: string | null
  
  user-defined task identifier
  
  optional field
  
  the character limit is 255
  
  you can use this parameter to identify the task and match it with the result
  
  you will find the specified tag value in the data object of the response

Responses

200
Type: object | null · Response36Afe1097B20_SerpGoogleFinanceTickerSearchLiveAdvancedResponseInfo
cost
Type: number | null Format: double

total tasks cost, USD

status_code
Type: integer | null

general status code you can find the full list of the response codes here

status_message
Type: string | null

general informational message you can find the full list of general informational messages here

tasks
Type: array (object | null)[] | null

array of tasks

Type: object | null · Response36Afe1097B20_SerpGoogleFinanceTickerSearchLiveAdvancedTaskInfo
cost
Type: number | null Format: double

total tasks cost, USD

data
Type: object | null

contains the same parameters that you specified in the POST request

propertyName
Type: object | null
id
Type: string | null

task identifier unique task identifier in our system in the UUID format

path
Type: array (string | null)[] | null

URL path

result
Type: array (object | null)[] | null

array of results

check_url
Type: string | null

direct URL to search engine results
you can use it to make sure that we provided accurate results

datetime
Type: string | null

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

item_types
Type: array (string | null)[] | null

types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_market_index, google_finance_asset_pair, google_finance_market_instrument

items
Type: array (object | null)[] | null

items of search results found in SERP
array of items containing market indexes data;
possible type of items: google_finance_market_index, google_finance_asset_pair, google_finance_market_instrument

displayed_name
Type: string | null

name of the market index as displayed on Google Finance
example: CAC 40

identifier
Type: string | null

identifier of the element
full identifier of the element that consists from ticker and market_identifier
example: PX1:INDEXDB

location
Type: string | null

location of the market index
example: Europe/Paris

percentage_delta
Type: number | null

percentage of change in value of the market index

rank_absolute
Type: integer | null

absolute rank in SERP
absolute position among all the elements in SERP

rank_group
Type: integer | null

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

timestamp
Type: string | null

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

trend
Type: string | null

growth trend of the market index
possible values: up, down, stable

type
Type: string | null

type of element

url
Type: string | null

URL to the page of the market index on Google Finance

items_count
Type: integer | null Format: int64

the number of results returned in the items array

keyword
Type: string | null

keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)

language_code
Type: string | null

language code in a POST array

location_code
Type: integer | null

location code in a POST array

refinement_chips
Type: object | null · Response36Afe1097B20_RefinementChipsInfo

search refinement chips
in this case, the value will be null

items
Type: array (object | null)[] | null

items of the element

domain
Type: string | null

domain in SERP

options
Type: array (object | null)[] | null

further search refinement options

domain
Type: string | null

domain in SERP

title
Type: string | null

title of the element

type
Type: string | null

type of element

url
Type: string | null

search URL with refinement parameters

title
Type: string | null

title of the element

type
Type: string | null

type of element

url
Type: string | null

search URL with refinement parameters

type
Type: string | null

type of element

xpath
Type: string | null

the XPath of the element

se_domain
Type: string | null

search engine domain in a POST array

se_results_count
Type: integer | null Format: int64

total number of results in SERP

spell
Type: object | null · Response36Afe1097B20_SpellInfo

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

keyword
Type: string | null

keyword obtained as a result of search engine autocorrection the results will be provided for the corrected keyword

type
Type: string | null

type of autocorrection possible values: did_you_mean, showing_results_for, no_results_found_for, including_results_for note: Yahoo and Yandex support only the following autocorrection type: including_results_for

type
Type: string | null

type of element

result_count
Type: integer | null Format: int64

number of elements in the result array

status_code
Type: integer | null

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

status_message
Type: string | null

informational message of the task you can find the full list of general informational messages here

time
Type: string | null

execution time, seconds

tasks_count
Type: integer | null Format: int64

the number of tasks in the tasks array

tasks_error
Type: integer | null Format: int64

the number of tasks in the tasks array returned with an error

time
Type: string | null

total execution time, seconds

version
Type: string | null

the current version of the API
application/json
400

The request could not be processed. Check the request parameters.
401

A valid Felo API key is required.
402

The request cannot proceed because a billing requirement is not met.
403

The account is not permitted to perform this operation.
429

A request or spending limit has been reached.
502

The service could not complete the request.
503

The API or billing service is temporarily unavailable.
504

The service timed out while processing the request.
default

Error response; upstream passthrough responses may use provider formats

application/json

post/v1/beta/dataforseo/serp/google/finance_ticker_search/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/finance_ticker_search/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_name": "English",
    "location_code": 2840,
    "category": "all",
    "keyword": "DJ"
  }
]'

Show Schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "identifier": null,
              "displayed_name": null,
              "url": null,
              "location": null,
              "trend": null,
              "timestamp": null,
              "percentage_delta": null
            }
          ]
        }
      ]
    }
  ]
}

Successful operation

Need help?

Contact Support for API, billing, and account questions.
Chat with Felo developers on Discord.
Check out our changelog.
Need volume pricing or procurement help? Contact Sales.
Building with an LLM? Read llms.txt.

Live Google Finance Ticker Search Advanced

AuthenticationRequired

DataForSEO

Live Google Finance Ticker Search Advanced

Pricing reference

Need help?