> ## Documentation Index
> Fetch the complete documentation index at: https://docs.surnex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Post v1dataforseoexecutions

> Compatibility route. Equivalent to POST /v1/executions with provider="dataforseo".



## OpenAPI

````yaml https://api.surnex.io/.well-known/openapi.json post /v1/dataforseo/executions
openapi: 3.1.0
info:
  title: Surnex API
  version: 0.2.0
servers:
  - url: https://api.surnex.io
security: []
paths:
  /v1/dataforseo/executions:
    post:
      tags:
        - v1
      description: >-
        Compatibility route. Equivalent to POST /v1/executions with
        provider="dataforseo".
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
                - type: object
                  properties:
                    service:
                      type: string
                      minLength: 1
                    method:
                      type: string
                      enum:
                        - GET
                        - POST
                      default: POST
                      description: HTTPMethod
                    mode:
                      type: string
                      enum:
                        - live
                        - task_post
                        - task_get
                        - tasks_ready
                        - tasks_fixed
                      default: live
                      description: DataForSeoOperationMode
                    request_body: {}
                    request_query:
                      type: object
                      additionalProperties:
                        anyOf:
                          - type: string
                          - type: number
                          - type: boolean
                          - type: 'null'
                          - type: 'null'
                      default: {}
                    expected_part_name:
                      type: string
                      minLength: 1
                      maxLength: 255
                    tags:
                      type: array
                      items:
                        type: string
                        maxLength: 64
                      maxItems: 10
                      default: []
                    operation_path:
                      type: string
                      minLength: 1
                  required:
                    - service
                    - operation_path
                  additionalProperties: false
                - type: object
                  properties:
                    service:
                      type: string
                      minLength: 1
                    method:
                      type: string
                      enum:
                        - GET
                        - POST
                      default: POST
                      description: HTTPMethod
                    mode:
                      type: string
                      enum:
                        - live
                        - task_post
                        - task_get
                        - tasks_ready
                        - tasks_fixed
                      default: live
                      description: DataForSeoOperationMode
                    request_body: {}
                    request_query:
                      type: object
                      additionalProperties:
                        anyOf:
                          - type: string
                          - type: number
                          - type: boolean
                          - type: 'null'
                          - type: 'null'
                      default: {}
                    expected_part_name:
                      type: string
                      minLength: 1
                      maxLength: 255
                    tags:
                      type: array
                      items:
                        type: string
                        maxLength: 64
                      maxItems: 10
                      default: []
                    operation_template:
                      type: string
                      minLength: 1
                    path_variables:
                      type: object
                      additionalProperties:
                        anyOf:
                          - type: string
                          - type: number
                          - type: boolean
                      default: {}
                  required:
                    - service
                    - operation_template
                  additionalProperties: false
              description: DataForSeoOperationRequest
            examples:
              executeByTemplate:
                value:
                  service: serp
                  operation_template: /serp/{se}/{type}/live
                  method: POST
                  mode: live
                  path_variables:
                    se: google
                    type: organic
                  request_body:
                    keyword: seo
              executeByPath:
                value:
                  service: serp
                  operation_path: /serp/google/organic/task_post
                  method: POST
                  mode: task_post
                  request_body:
                    keyword: seo
                    target: example.com
      responses:
        '200':
          description: Execution queued
          content:
            application/json:
              schema:
                type: object
                properties:
                  execution_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - queued
                      - running
                      - complete
                      - partial
                      - failed
                  operation:
                    type: object
                    properties:
                      service:
                        type: string
                      operation_path:
                        type: string
                      method:
                        type: string
                        enum:
                          - GET
                          - POST
                        description: HTTPMethod
                      mode:
                        type: string
                        enum:
                          - live
                          - task_post
                          - task_get
                          - tasks_ready
                          - tasks_fixed
                        description: DataForSeoOperationMode
                    required:
                      - service
                      - operation_path
                      - method
                      - mode
                  scope:
                    type: object
                    properties:
                      part_type:
                        type: string
                      snapshot_id:
                        type: string
                        format: uuid
                    required:
                      - part_type
                      - snapshot_id
                  provider:
                    type: string
                required:
                  - execution_id
                  - status
                  - operation
                  - scope
                  - provider
              examples:
                queued:
                  value:
                    execution_id: f47ac10b-58cc-4372-a567-0e02b2c3d479
                    status: queued
                    operation:
                      service: serp
                      operation_path: /serp/google/organic/live
                      method: POST
                      mode: live
                    scope:
                      part_type: serp_google_organic_live
                      snapshot_id: f47ac10b-58cc-4372-a567-0e02b2c3d479
                    provider: dataforseo
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                      details:
                        type: object
                        properties: {}
                        default: {}
                        additionalProperties: {}
                    required:
                      - code
                      - message
                      - request_id
                required:
                  - error
                description: ErrorResponse
              examples:
                badRequest:
                  value:
                    error:
                      code: VALIDATION_ERROR
                      message: Invalid request
                      request_id: req_123
                      details:
                        issues:
                          - path:
                              - operation_path
                            message: Invalid operation path
                            code: invalid_string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                      details:
                        type: object
                        properties: {}
                        default: {}
                        additionalProperties: {}
                    required:
                      - code
                      - message
                      - request_id
                required:
                  - error
                description: ErrorResponse
              examples:
                unauthorized:
                  value:
                    error:
                      code: UNAUTHORIZED
                      message: Unauthorized
                      request_id: req_123
                      details:
                        reason: missing_or_invalid_api_key
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Authorization: Bearer sk_...'
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````