README
¶
App Store clients for Crawlora
Official Crawlora client packages for the hosted App Store API. Access 15 API endpoints covering app search, details, reviews, ratings, privacy labels, version history, charts, editorial collections, and developers from JavaScript/TypeScript, Python, Go, Ruby, Java, and PHP. These clients call Crawlora's hosted API; they do not scrape App Store locally. Requests use your Crawlora account and CRAWLORA_API_KEY; service usage follows your account billing plan. Crawlora is independent from and not affiliated with or endorsed by App Store or its owners.
Language packages
- JavaScript / TypeScript:
@crawlora-org/appstore - Python:
crawlora-appstore - Go:
github.com/Crawlora-org/crawlora-appstore - Ruby:
crawlora-appstore - Java:
net.crawlora:crawlora-appstore:0.1.2 - PHP:
crawlora/appstore
For installation and runnable examples, use the README for your language. See the API endpoint and parameter reference for shared operation details.
Create an account at crawlora.net, open the Crawlora console to get an API key, or read the API documentation. Keep CRAWLORA_API_KEY out of source control.
API coverage and supported endpoints
The six language clients provide access to all 15 selected public App Store API operations. Search or browse by endpoint path and operation ID below; the complete API reference adds parameters, enums, and response details.
| Method | Endpoint | API operation | Description |
|---|---|---|---|
GET |
/appstore/app |
appstore-app |
Retrieve full App Store app details |
GET |
/appstore/categories |
appstore-categories |
Retrieve App Store chart categories and collections |
GET |
/appstore/collection |
appstore-collection |
Retrieve apps in one App Store collection |
GET |
/appstore/collections |
appstore-collections |
Discover App Store editorial collections |
GET |
/appstore/developer/{dev_id} |
appstore-developer |
Retrieve apps by developer ID |
GET |
/appstore/editorial |
appstore-editorial |
Retrieve an App Store device or Arcade editorial landing page |
GET |
/appstore/editorial/category |
appstore-editorial-category |
Retrieve an App Store category-scoped editorial page |
GET |
/appstore/list |
appstore-list |
Retrieve App Store collection rankings |
GET |
/appstore/privacy/{id} |
appstore-privacy |
Retrieve App Store privacy disclosures |
GET |
/appstore/ratings |
appstore-ratings |
Retrieve App Store ratings histogram |
GET |
/appstore/reviews |
appstore-reviews |
Retrieve App Store reviews |
GET |
/appstore/search |
appstore-search |
Search the App Store |
GET |
/appstore/similar |
appstore-similar |
Retrieve "You Might Also Like" apps |
GET |
/appstore/suggest/{term} |
appstore-suggest |
Retrieve App Store search suggestions |
GET |
/appstore/version-history/{id} |
appstore-version-history |
Retrieve App Store version history |
License
MIT. See LICENSE.
Documentation
¶
Overview ¶
Package appstore is Crawlora's App Store API client for 15 endpoints, covering app search, details, reviews, ratings, privacy labels, version history, charts, editorial collections, and developers. API documentation: https://crawlora.net/docs?utm_source=pkg.go.dev&utm_medium=referral&utm_campaign=platform-clients&utm_content=appstore-go-api-docs
Index ¶
- Constants
- func OperationIDs() []string
- type Client
- func (c *Client) App(ctx context.Context, params Params) (any, error)
- func (c *Client) Call(ctx context.Context, operationID string, params Params) (any, error)
- func (c *Client) Categories(ctx context.Context, params Params) (any, error)
- func (c *Client) Close() error
- func (c *Client) Collection(ctx context.Context, params Params) (any, error)
- func (c *Client) Collections(ctx context.Context, params Params) (any, error)
- func (c *Client) Developer(ctx context.Context, params Params) (any, error)
- func (c *Client) Editorial(ctx context.Context, params Params) (any, error)
- func (c *Client) EditorialCategory(ctx context.Context, params Params) (any, error)
- func (c *Client) List(ctx context.Context, params Params) (any, error)
- func (c *Client) Privacy(ctx context.Context, params Params) (any, error)
- func (c *Client) Ratings(ctx context.Context, params Params) (any, error)
- func (c *Client) Reviews(ctx context.Context, params Params) (any, error)
- func (c *Client) Search(ctx context.Context, params Params) (any, error)
- func (c *Client) Similar(ctx context.Context, params Params) (any, error)
- func (c *Client) Suggest(ctx context.Context, params Params) (any, error)
- func (c *Client) VersionHistory(ctx context.Context, params Params) (any, error)
- type Params
Examples ¶
Constants ¶
const ( DefaultBaseURL = "https://api.crawlora.net/api/v1" Version = "0.1.2" )
const OperationCount = 15
OperationCount reports how many selected-platform operations this module exposes.
Variables ¶
This section is empty.
Functions ¶
func OperationIDs ¶
func OperationIDs() []string
OperationIDs returns the selected operation IDs in stable sorted order.
Types ¶
type Client ¶
Client calls only the operation IDs included in this platform module.
func NewClient ¶
NewClient creates a client using the supplied API key, or CRAWLORA_API_KEY when empty.
func (*Client) Call ¶
Call executes a selected platform operation by operation ID.
Example ¶
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
w.Header().Set("Content-Type", "application/json")
_, _ = w.Write([]byte(`{"ok":true}`))
}))
defer server.Close()
client := NewClient("your-crawlora-api-key")
client.BaseURL = server.URL + "/api/v1"
client.HTTPClient = server.Client()
result, err := client.Call(context.Background(), "appstore-app", Params{})
if err != nil {
panic(err)
}
fmt.Println(result.(map[string]any)["ok"])
Output: true
func (*Client) Categories ¶
Categories calls the appstore-categories operation.
func (*Client) Collection ¶
Collection calls the appstore-collection operation.
func (*Client) Collections ¶
Collections calls the appstore-collections operation.
func (*Client) EditorialCategory ¶
EditorialCategory calls the appstore-editorial-category operation.
Source Files