discovery

Estimate monthly SERP provider cost

Changed on
get/cost-estimate

Request

  • Base URL: https://eu.bisibility.com/api/v1
  • URL: https://eu.bisibility.com/api/v1/cost-estimate
  • Auth: none declared

Query parameters

cron_expressionstring

Custom cron expression; an invalid or missing expression leaves monthly estimates unknown.

keywordsinteger required

Keyword count. Must be an integer greater than or equal to 0.

depth10 | 20 | 50 | 100

Organic result depth per logical rank check.

locationsinteger

Market count per keyword; each market combines a location and language.

devicesinteger

Device count per keyword.

frequency'daily' | 'weekly' | 'monthly' | 'manual' | 'paused' | 'custom_cron'

Rank-check frequency used to estimate monthly checks.

providerstring

Provider rate card ID from GET /provider-rates. An unknown provider returns 404.

optionstring

Flat-rate provider option key from the provider's rate card, such as standard, priority or live.

planstring

Plan-model provider plan key from the provider's rate card; unknown values use auto selection.

Headers

Bisibility-API-Version'v1'

API contract version requested by the client. Omit this header to use the current backward-compatible behavior.

Response

JSON response

Changes

  • a6e1ec0dec82Revision changes
    • breaking

      removed the enum value 1.00 from the query request parameter devices

    • breaking

      removed the enum value 2.00 from the query request parameter devices

    • breaking

      removed the enum value bigdata from the query request parameter plan

    • breaking

      removed the enum value dataforseo from the query request parameter provider

    • breaking

      removed the enum value developer from the query request parameter plan

    • breaking

      removed the enum value free from the query request parameter plan

    • breaking

      removed the enum value live from the query request parameter option

    • breaking

      removed the enum value priority from the query request parameter option

    • breaking

      removed the enum value production from the query request parameter plan

    • breaking

      removed the enum value serpapi from the query request parameter provider

    • breaking

      removed the enum value standard from the query request parameter option

    • breaking

      removed the enum value starter from the query request parameter plan

    • breaking

      for the query request parameter option, the minLength was increased from 0 to 1

    • breaking

      for the query request parameter plan, the minLength was increased from 0 to 1

    • breaking

      for the query request parameter provider, the minLength was increased from 0 to 1

    • breaking

      the response's property type changed from object to no type for status

    • warning

      for the query request parameter option, the maxLength was set to 80

    • warning

      for the query request parameter plan, the maxLength was set to 80

    • warning

      for the query request parameter provider, the maxLength was set to 80

    • warning

      for the query request parameter devices, the max was set to 2.00

    • warning

      for the query request parameter devices, the min was set to 1.00

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added subschema #1 subschema #2 subschema #3 to the response property anyOf list for the response status