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

# Seed a market with the keywords of its own listing

> Captures the listing of the app in one storefront now, extracts the title and subtitle phrases of that listing, of its native localizations and of every localization the app ships that the storefront reads besides its default, tracks up to 15 of them in that market as listing keywords within the keyword room of the plan, queues their first score and first position check, and asks for the listings of the competitors there. A phrase the app already tracks there, active or paused, is left as it is. Phrases the room cannot hold are counted in skipped, never refused. Answers status unavailable and writes nothing when the store has no listing of the app in that storefront. Spends one refresh allowance once the store is asked, so a refusal costs nothing. Answers 400 for the home market, for a competitor app and for a code that is not a storefront of the store the app is in, 404 for an unknown app and 429 when the refresh allowance is spent.



## OpenAPI

````yaml /api-reference/openapi.json post /apps/{id}/market-seed
openapi: 3.0.0
info:
  title: asobeast API
  description: >-
    Self hosted ASO toolkit API.


    A metered instance carries RateLimit-Limit, RateLimit-Remaining and
    RateLimit-Reset on every response, for the tightest limit the request
    touched. A self hosted instance has no request rate limits and sends no such
    header. Limits are per workspace, so minting more tokens does not buy more
    capacity, and they are sized per plan across three classes: read for stored
    data, write for configuration changes and store for the endpoints that reach
    the App Store or Google Play.


    A 429 carries Retry-After and a rateLimit object naming the window that
    closed, or an aiAllowance object when the workspace has spent the AI calls
    its plan includes this month. A 403 with a quota object means a plan
    capacity limit such as apps or tracked keyword markets, which is a different
    problem from a rate limit. A 402 with an entitlement object means the
    workspace needs a plan.


    Positions are 1-based and null means checked but not found within the
    captured depth, never zero. Daily granularity uses UTC dates.
  version: 1.9.0
  contact: {}
servers:
  - url: http://localhost:3000/api/backend
    description: Web origin proxy
  - url: http://localhost:4000
    description: Direct API
security:
  - personalApiToken: []
tags: []
paths:
  /apps/{id}/market-seed:
    post:
      tags:
        - apps
      summary: Seed a market with the keywords of its own listing
      description: >-
        Captures the listing of the app in one storefront now, extracts the
        title and subtitle phrases of that listing, of its native localizations
        and of every localization the app ships that the storefront reads
        besides its default, tracks up to 15 of them in that market as listing
        keywords within the keyword room of the plan, queues their first score
        and first position check, and asks for the listings of the competitors
        there. A phrase the app already tracks there, active or paused, is left
        as it is. Phrases the room cannot hold are counted in skipped, never
        refused. Answers status unavailable and writes nothing when the store
        has no listing of the app in that storefront. Spends one refresh
        allowance once the store is asked, so a refusal costs nothing. Answers
        400 for the home market, for a competitor app and for a code that is not
        a storefront of the store the app is in, 404 for an unknown app and 429
        when the refresh allowance is spent.
      operationId: MarketSeedController_seed
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarketSeedDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
components:
  schemas:
    MarketSeedDto:
      type: object
      properties:
        country:
          type: string
          example: de
          pattern: ^[a-z]{2}$
      required:
        - country
  securitySchemes:
    personalApiToken:
      scheme: bearer
      bearerFormat: asob
      type: http

````

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