{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "",
    "title": "Serpstat",
    "version": "1",
    "x-aisa-capabilities": {
      "idempotency": "Idempotency-Key",
      "max_price": "X-AISA-Max-Price-USD",
      "quote": {
        "header": "X-AISA-Cost-Mode",
        "value": "quote"
      }
    },
    "x-aisa-configured-paths": [
      "/apis/v1/serpstat/google-domain-competitors",
      "/apis/v1/serpstat/google-domain-overview",
      "/apis/v1/serpstat/google-domain-ranked-keywords",
      "/apis/v1/serpstat/google-keywords-ideas",
      "/apis/v1/serpstat/google-keywords-volume",
      "/apis/v1/serpstat/google-serp-organic",
      "/apis/v1/serpstat/web-anchors-list",
      "/apis/v1/serpstat/web-backlinks-list",
      "/apis/v1/serpstat/web-backlinks-summary",
      "/apis/v1/serpstat/web-linking-domains-list",
      "/apis/v1/serpstat/web-site-top-pages"
    ],
    "x-aisa-document": {
      "facts_hash": "637b6ee580d4cc565045bbb32223a576f166452d2fa09b87586aad5ba5bd550e",
      "generator_version": "3",
      "protocol_version": "1",
      "schema_version": "1",
      "composer_version": "27",
      "response_pending": [
        {
          "operation_id": "serpstat.google-serp-organic",
          "path": "/apis/v1/serpstat/google-serp-organic",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        }
      ],
      "document_hash": "sha256:44883939b7fa20eeece35c47e039aa4f09521b2b3b016987370e52eb560c3e97"
    },
    "x-aisa-plans": {
      "builder": 1.0,
      "display_plan": "payg",
      "payg": 1.0,
      "similarweb_payg": 1.0,
      "team": 1.0,
      "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
    },
    "x-aisa-provider": "serpstat",
    "x-aisa-catalogs": {
      "serpstat": {
        "title": "Serpstat",
        "description": "",
        "x-aisa-document": {
          "facts_hash": "637b6ee580d4cc565045bbb32223a576f166452d2fa09b87586aad5ba5bd550e",
          "generator_version": "3",
          "protocol_version": "1",
          "schema_version": "1"
        },
        "x-aisa-plans": {
          "builder": 1.0,
          "display_plan": "payg",
          "payg": 1.0,
          "similarweb_payg": 1.0,
          "team": 1.0,
          "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
        },
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          }
        }
      }
    }
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "openapi": "3.1.0",
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "paths": {
    "/apis/v1/serpstat/google-serp-organic": {
      "post": {
        "description": "<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.05 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "serpstat.google-serp-organic",
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "default": {
                  "value": {
                    "id": "example",
                    "method": "SerpstatKeywordProcedure.getKeywordTop",
                    "params": {
                      "keyword": "nike",
                      "se": "g_us",
                      "size": 10
                    }
                  }
                },
                "minimal": {
                  "value": {
                    "id": "example",
                    "method": "SerpstatKeywordProcedure.getKeywordTop",
                    "params": {
                      "keyword": "nike",
                      "se": "g_us",
                      "size": 10
                    }
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "maxLength": 64,
                    "minLength": 1,
                    "type": "string"
                  },
                  "method": {
                    "enum": [
                      "SerpstatKeywordProcedure.getKeywordTop"
                    ],
                    "type": "string"
                  },
                  "params": {
                    "additionalProperties": false,
                    "properties": {
                      "keyword": {
                        "maxLength": 200,
                        "minLength": 1,
                        "type": "string"
                      },
                      "se": {
                        "enum": [
                          "g_us"
                        ],
                        "type": "string"
                      },
                      "size": {
                        "enum": [
                          10
                        ],
                        "maximum": 9223372036854775807,
                        "minimum": 0,
                        "type": "integer"
                      }
                    },
                    "required": [
                      "keyword",
                      "se",
                      "size"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "method",
                  "params"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful response"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Google organic results by keyword — ranking URLs, titles",
        "tags": [
          "Serpstat"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "seo",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "default_request_estimate_usd": 0.05,
          "estimate_source": "profile_seed",
          "evidence_source": "response_header",
          "unit": "provider_credit",
          "unit_rate_usd": 1e-06
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": false
        },
        "x-aisa-response-passthrough": true,
        "x-aisa-response-upstream-origin-sha256": "ee07509144cafbd5e3d183b49ccff2d261749fdb61ea649e385bf9803e6d4e3d",
        "x-aisa-response-upstream-path-sha256": "205a794880a0d5434a6e1bb740d00fe3217f6f052b69adb37c0fec757c56a627",
        "x-aisa-revision": {
          "customer_pricing_ref": "fda7874df42d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "19ce0af934be"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "serpstat",
        "x-aisa-runtime-operation": {
          "operation_id": "serpstat.google-serp-organic",
          "method": "POST",
          "path": "/apis/v1/serpstat/google-serp-organic"
        },
        "x-aisa-response-pending": {
          "operation_id": "serpstat.google-serp-organic",
          "path": "/apis/v1/serpstat/google-serp-organic",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/serpstat/google-serp-organic \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"id\": \"example\",\n  \"method\": \"SerpstatKeywordProcedure.getKeywordTop\",\n  \"params\": {\n    \"keyword\": \"nike\",\n    \"se\": \"g_us\",\n    \"size\": 10\n  }\n}'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serpstat/serpstat-google-serp-organic"
      }
    }
  }
}