> ## 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.

# Read what one market search reads

> Answers every localization the storefront of the market reads, in read order, with its role (default or additional), whether the app ships it, its origin (home, manual or detected, null when it is not shipped), its saved phrases and the characters they use. Without a query it describes the home storefront of the app. Any App Store storefront may be asked for, whether or not the app tracks keywords there. Answers 400 when country is neither the home storefront nor an App Store storefront and for a Google Play or competitor app, and 404 for a missing app.



## OpenAPI

````yaml /api-reference/openapi.json get /apps/{id}/keyword-fields/market
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}/keyword-fields/market:
    get:
      tags:
        - keywords
      summary: Read what one market search reads
      description: >-
        Answers every localization the storefront of the market reads, in read
        order, with its role (default or additional), whether the app ships it,
        its origin (home, manual or detected, null when it is not shipped), its
        saved phrases and the characters they use. Without a query it describes
        the home storefront of the app. Any App Store storefront may be asked
        for, whether or not the app tracks keywords there. Answers 400 when
        country is neither the home storefront nor an App Store storefront and
        for a Google Play or competitor app, and 404 for a missing app.
      operationId: LocalizationsController_marketKeywordFields
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
        - name: country
          required: false
          in: query
          description: >-
            The storefront whose search is described. Omitted means the home
            storefront of the app.
          schema:
            type: string
            example: us
            pattern: ^[a-z]{2}$
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    personalApiToken:
      scheme: bearer
      bearerFormat: asob
      type: http

````

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