Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Setting Live ‘Bing Ads Keyword Suggestions for URL’ Tasks

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

Setting Live ‘Bing Ads Keyword Suggestions for URL’ Tasks

​

Suggests Bing keywords for one page target, reading the page itself rather than a seed list. exclude_brands drops brand terms, language_code scopes it. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Use it when you have a URL and no keyword list yet; once you have seeds, post_dataforseo_keywords_bing_kw_for_keywords_live expands them. The submit and fetch twins of this endpoint do the same work asynchronously, at the same price, for batches too large to wait on.

Body
required
application/json
  • Type: array object[]
      • language_name
        Type: string
        required

        Full name of the search engine language. Required if language_code is not supplied; either language_name or language_code is sufficient.

      • target
        Type: string
        required

        target URL of the webpage to scan for possible keywords required field maximum length: 2000 characters

      • exclude_brands
        Type: boolean

        determines whether the results exclude brand keywords optional field

      • 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 with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_suggestions_for_url/languages example: en

Responses
  • 200
    Type: object

    Successful response

    • cost
      Type: number

      total tasks cost, USD

    • status_code
      Type: integer

      general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions

    • status_message
      Type: string

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

    • tasks
      Type: array string[]

      array of tasks

    • tasks_count
      Type: integer

      the number of tasks in the tasks array

    • tasks_error
      Type: integer

      the number of tasks in the tasks array that were returned an error

    • tasks.cost
      Type: number

      cost of the task, USD

    • tasks.data
      Type: object

      contains the same parameters that you specified in the POST request

    • tasks.id
      Type: string

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

    • tasks.path
      Type: array string[]

      URL path

    • tasks.result
      Type: array string[]

      array of results results are sorted in order from keywords with the highest confidence score to those with the lowest confidence score

    • tasks.result_count
      Type: integer

      number of elements in the result array

    • tasks.result.confidence_score
      Type: number

      a score from 0.0 to 1.0 that indicates the probability that the keyword would match a user’s search query

    • tasks.result.keyword
      Type: string

      suggested keyword

    • tasks.status_code
      Type: integer

      status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of response codes here

    • tasks.status_message
      Type: string

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

    • tasks.time
      Type: string

      execution time, seconds

    • time
      Type: string

      execution time, seconds

    • version
      Type: string

      the current version of the API

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

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

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 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

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for post/v1/beta/dataforseo/keywords_data/bing/keyword_suggestions_for_url/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_suggestions_for_url/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {}
]'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.keyword": "string",
  "tasks.result.confidence_score": 1
}

Successful response

Setting Live ‘Bing Ads Keyword Suggestions for URL’ Tasks