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

# Find keywords and more competitors

> Reads Search Console when it is connected, otherwise DataForSEO Labs, and writes up to 50 keywords with their volume and position. Adds competitors that rank for the same keywords or are named next to the brand in recorded AI answers, each with its reason. Running it again replaces what it wrote; keywords and competitors you added stay. One step runs at a time per project, and only before tracking starts. Follow the job with `GET /v1/jobs/{id}`.



## OpenAPI

````yaml https://api.seomator.com/openapi.json post /v1/projects/{id}/onboarding/keywords
openapi: 3.1.0
info:
  title: SEOmator API
  version: 0.1.0
servers:
  - url: https://api.seomator.com
security: []
paths:
  /v1/projects/{id}/onboarding/keywords:
    post:
      tags:
        - ai visibility
      summary: Find keywords and more competitors
      description: >-
        Reads Search Console when it is connected, otherwise DataForSEO Labs,
        and writes up to 50 keywords with their volume and position. Adds
        competitors that rank for the same keywords or are named next to the
        brand in recorded AI answers, each with its reason. Running it again
        replaces what it wrote; keywords and competitors you added stay. One
        step runs at a time per project, and only before tracking starts. Follow
        the job with `GET /v1/jobs/{id}`.
      parameters:
        - schema:
            type: string
            description: Project id (proj_…) or slug (the domain with dots as dashes).
          required: true
          description: Project id (proj_…) or slug (the domain with dots as dashes).
          name: id
          in: path
      responses:
        '202':
          description: The step is queued
          content:
            application/json:
              schema:
                type: object
                properties:
                  job:
                    type: object
                    properties:
                      id:
                        type: string
                      projectId:
                        type: string
                      type:
                        type: string
                      status:
                        type: string
                        enum:
                          - queued
                          - running
                          - done
                          - failed
                      error:
                        type:
                          - string
                          - 'null'
                      chunksTotal:
                        type: number
                      chunksDone:
                        type: number
                      createdAt:
                        type: string
                      startedAt:
                        type:
                          - string
                          - 'null'
                      finishedAt:
                        type:
                          - string
                          - 'null'
                    required:
                      - id
                      - projectId
                      - type
                      - status
                      - error
                      - chunksTotal
                      - chunksDone
                      - createdAt
                      - startedAt
                      - finishedAt
                    additionalProperties: {}
                required:
                  - job
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Try again later
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - bad_request
                - unauthorized
                - insufficient_credits
                - plan_limit
                - forbidden
                - not_found
                - conflict
                - rate_limit_exceeded
                - internal_server_error
                - service_unavailable
            message:
              type: string
            requestId:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

## Related topics

- [MCP server: connect Claude, ChatGPT and more](https://docs.seomator.com/mcp/setup.md)
- [Projects: set up, track and manage a site](https://docs.seomator.com/getting-started/projects.md)
- [List the project’s own brand and tracked competitors](https://docs.seomator.com/api-reference/ai-visibility/list-the-project’s-own-brand-and-tracked-competitors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.