---
title: "Draft the store listing for a site's app"
method: GET
path: "/sites/{id}/store-listing"
tags: ["Sites"]
---

# Draft the store listing for a site's app

`GET /sites/{id}/store-listing`

## Request

- Base URL: `https://api.hypamoon.com/api/v1`
- URL: `https://api.hypamoon.com/api/v1/sites/{id}/store-listing`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.hypamoon.com/oauth/authorize`, token URL `https://api.hypamoon.com/oauth/token`, scopes: `sites:read`)

A first draft of the App Store and Google Play listing from the site's own text, within each store's limits: name, subtitle, promotional text, description and keywords (Apple), title, short and full description (Google), a category, review notes, and which screenshots and graphics to make per store. In English; source_language says when the site is in another language and the texts need translating. No prices and no purchase links.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `app_name` string

## Response `200`

The draft listing.

- object
  - `site` object, required
    - `id` string, required
    - `app_url` string, required
  - `source_language` string, required
  - `note` string, required
  - `apple` object, required
    - `name` string, required
    - `subtitle` string, required
    - `promotional_text` string, required
    - `description` string, required
    - `keywords` string, required
    - `primary_category` string, required
    - `secondary_category` string, nullable, required
    - `support_url` string, nullable, required
    - `privacy_policy_url` string, nullable, required
  - `google_play` object, required
    - `title` string, required
    - `short_description` string, required
    - `full_description` string, required
    - `category` string, required
    - `contact_email` string, nullable, required
    - `privacy_policy_url` string, nullable, required
  - `category_reason` string, required
  - `review_notes` string, required
  - `screenshots` object, required
    - `required` object[], required
      - `store` 'apple' | 'google_play', required
      - `device` string, required
      - `size` string, required
      - `count` string, required
      - `required` boolean, required
    - `graphics` object[], required
      - `store` string, required
      - `what` string, required
      - `size` string, required
      - `required` boolean, required
    - `screens_to_capture` string[], required
    - `ipad_note` string, required
  - `limits` object, required
    - `apple` object, required
      - `name` number, required
      - `subtitle` number, required
      - `promotional_text` number, required
      - `description` number, required
      - `keywords` number, required
    - `google_play` object, required
      - `title` number, required
      - `short_description` number, required
      - `full_description` number, required

## Other responses

- `401`: Unauthorized: unauthorized, missing_api_key, invalid_api_key, api_key_revoked, project_deleted.
- `403`: Forbidden: project_not_enabled, key_mode_mismatch, missing_scope, verification_required.
- `404`: Not Found: not_found.
- `422`: Unprocessable Content: validation_failed.
- `429`: Too Many Requests: rate_limited.
- `500`: Internal Server Error: internal_error.
- `503`: Service Unavailable: service_unavailable.

---

[API](https://skmtc.dev/hypamoon/apis/hypamoon-api.md) · [All operations](https://skmtc.dev/hypamoon/apis/hypamoon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hypamoon/apis/hypamoon-api/revisions/9f0b90004c06?raw)