Skip to content

v1.15.0: Top 50 search results, chart and review alerts, and keyword imports from other tools

Choose a tag to compare

@github-actions github-actions released this 31 Oct 21:30
298adfb

AsoBeast 1.15.0 shows the top 50 of every keyword search with icons and movement, alerts you when an app enters or leaves a top chart or gets a new review, and imports keyword files from Astro, Sonar and AppFollow as they are. Rank drop alerts can now wait for the next check before they reach you. The AI features work with any OpenAI compatible provider, Ollama on your own machine included.

curl -fsSLO https://raw.githubusercontent.com/AsoBeast/asobeast/v1.15.0/docker-compose.pull.yml
docker compose -f docker-compose.pull.yml pull
docker compose -f docker-compose.pull.yml up -d --wait

🌟 Highlights

Top 50 search results

The list button on a keyword row opens a new Search results sheet. It shows the top 50 of each daily check instead of the top 10, with app icons, movement since the previous check and the apps that dropped out. The keyword's words are marked in every title. From a row you can open the app in its store or track it as a competitor. (#645) Read more

Alerts for charts, new reviews and drops that hold

  • An owned app that enters a top chart, leaves it, or crosses first place, the top 3 or the top 10 inside it raises an alert. (#630)
  • review.new fires for every new review. A star filter lets a channel take only the 1 and 2 star ones. (#631)
  • With Confirm drops before alerting, a rank drop is sent only once the next check confirms it, and a drop that recovers sends nothing. Channels you add in Settings start with it ticked. Existing channels, and channels created through the API without the field, keep the old behaviour. (#629)

Read more

Bring your keywords from another tool

The Import CSV dialog reads the keyword exports of Astro, Sonar and AppFollow by their headers. A file that covers several apps is narrowed to the one you are on, and a country written as Poland or 🇵🇱 becomes its storefront code. A file longer than 500 rows is imported in parts, one after the other. (#638, #642) Read more

Keyword field from App Store Connect

With App Store Connect connected, an owner can have AsoBeast import the private keyword field of every localization the key can read. The field you maintain in App Store Connect becomes the one AsoBeast tracks, and the metadata page shows it read only. The first import never replaces a field you typed with an empty one. Thanks @coolswood. (#636) Read more

Any OpenAI compatible AI provider

Set OPENAI_BASE_URL to send AI requests to OpenRouter, Ollama, LM Studio, vLLM, LiteLLM, Groq or Azure OpenAI. Leave it empty and nothing changes. (#641) Read more

✨ Also new

  • Click a keyword's position to see its history, with the days your listing changed marked on the chart (#620)
  • Copy or download a rank chart as a PNG (#637)
  • A Ratings by market card on the app overview (#633)
  • Added and Competitors in top 10 columns in the keyword table, both off by default (#634)
  • Pause, resume or untrack hundreds of keywords at once without hitting the rate limit (#635)
  • Popularity marks the keywords where Apple answered its floor value, and their scores read as lower confidence (#632)

🐛 Fixes

  • Pages translated by the browser no longer crash on buttons, selects, the keyword import or the search results (#613, #649, #653)
  • An icon change is recorded only when its pixels change, not when the CDN address does. Thanks @coolswood (#600)
  • Large store reports apply, and a report sync retries before it warns about failed reports (#611, #643)
  • A small Google Play chart that empties overnight no longer fails its job for a week, and a job waiting for a busy proxy goes back to the queue without spending a retry (#621)
  • Comments in the .env examples no longer end up inside Compose values (#616)

⚠️ Upgrade notes

  • Four small forward migrations apply on start: confirmDrops and reviewScores on webhooks and email alerts, and a new KeywordFieldSync table. No existing data is rewritten.
  • Two new optional environment variables: OPENAI_BASE_URL (empty uses OpenAI) and RETENTION_SERP_DEEP_DAYS (default 30), which prunes search positions 11 to 50 after 30 days. The top 10 keeps following RETENTION_SERP_DAYS.
  • API additions only. New POST /apps/{id}/keywords/bulk, the chart.entered, chart.left, chart.milestone and review.new events, and optional fields on search results, tracked keywords and listing markets. Nothing is removed or renamed. The MCP tool list is the same, and list_keywords now describes the new fields.

Take a backup first, as always.

Full Changelog: v1.14.0...v1.15.0