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

# Suggest storefronts from the languages the home listing declares

> Reads the languages the newest home listing declares and answers every App Store storefront that reads a localization in one of them, the home storefront left out, with the localization, its role in that storefront (default or additional), whether the app already tracks keywords there and the daily store requests the market costs: the listing reads of the app and its competitors, native localizations and the localizations the app ships there included, and the requests one tracked keyword adds. English is never suggested because every storefront reads it. A Google Play app and a competitor app answer an empty list. Answers 404 for an unknown app.



## OpenAPI

````yaml /api-reference/openapi.json get /apps/{id}/market-suggestions
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-suggestions:
    get:
      tags:
        - apps
      summary: Suggest storefronts from the languages the home listing declares
      description: >-
        Reads the languages the newest home listing declares and answers every
        App Store storefront that reads a localization in one of them, the home
        storefront left out, with the localization, its role in that storefront
        (default or additional), whether the app already tracks keywords there
        and the daily store requests the market costs: the listing reads of the
        app and its competitors, native localizations and the localizations the
        app ships there included, and the requests one tracked keyword adds.
        English is never suggested because every storefront reads it. A Google
        Play app and a competitor app answer an empty list. Answers 404 for an
        unknown app.
      operationId: MarketSuggestionsController_suggest
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      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.