googleplay

README

Google Play clients for Crawlora

Official Crawlora client packages for the hosted Google Play API. These clients call Crawlora's hosted API; they do not scrape Google Play 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 Google Play or its owners.

Language packages

• JavaScript / TypeScript: @crawlora-org/googleplay
• Python: crawlora-googleplay
• Go: github.com/Crawlora-org/crawlora-googleplay
• Ruby: crawlora-googleplay
• Java: net.crawlora:crawlora-googleplay:0.1.0
• PHP: crawlora/googleplay

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

The six clients provide access to 11 public API operations. See the API reference for supported operations, parameters, and response details.

License

MIT. See LICENSE.

Documentation

Overview

Package googleplay is a focused Go client for Crawlora's Google Play endpoints. API documentation: https://crawlora.net/docs?utm_source=pkg.go.dev&utm_medium=referral&utm_campaign=platform-clients&utm_content=googleplay-go-api-docs

Index

• Constants
• func OperationIDs() []string
• type Client
  • func NewClient(apiKey string) *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) Datasafety(ctx context.Context, params Params) (any, error)
  • func (c *Client) Developer(ctx context.Context, params Params) (any, error)
  • func (c *Client) List(ctx context.Context, params Params) (any, error)
  • func (c *Client) Permissions(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)
• type Params

Examples

• Client.Call

Constants

const (
	DefaultBaseURL = "https://api.crawlora.net/api/v1"
	Version        = "0.1.0"
)

const OperationCount = 11

OperationCount reports how many selected-platform operations this module exposes.

Functions

func OperationIDs

func OperationIDs() []string

OperationIDs returns the selected operation IDs in stable sorted order.

Types

type Client

type Client struct {
	APIKey     string
	BaseURL    string
	Timeout    time.Duration
	HTTPClient *http.Client
}

Client calls only the operation IDs included in this platform module.

func NewClient

func NewClient(apiKey string) *Client

NewClient creates a client using the supplied API key, or CRAWLORA_API_KEY when empty.

func (*Client) App

func (c *Client) App(ctx context.Context, params Params) (any, error)

App calls the googleplay-app operation.

func (*Client) Call

func (c *Client) Call(ctx context.Context, operationID string, params Params) (any, error)

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(), "googleplay-app", Params{"app_id": "sample"})
if err != nil {
	panic(err)
}
fmt.Println(result.(map[string]any)["ok"])

Output:
true

func (*Client) Categories

func (c *Client) Categories(ctx context.Context, params Params) (any, error)

Categories calls the googleplay-categories operation.

func (*Client) Close

func (c *Client) Close() error

Close releases idle connections held by the configured HTTP transport.

func (*Client) Datasafety

func (c *Client) Datasafety(ctx context.Context, params Params) (any, error)

Datasafety calls the googleplay-datasafety operation.

func (*Client) Developer

func (c *Client) Developer(ctx context.Context, params Params) (any, error)

Developer calls the googleplay-developer operation.

func (*Client) List

func (c *Client) List(ctx context.Context, params Params) (any, error)

List calls the googleplay-list operation.

func (*Client) Permissions

func (c *Client) Permissions(ctx context.Context, params Params) (any, error)

Permissions calls the googleplay-permissions operation.

func (*Client) Ratings

func (c *Client) Ratings(ctx context.Context, params Params) (any, error)

Ratings calls the googleplay-ratings operation.

func (*Client) Reviews

func (c *Client) Reviews(ctx context.Context, params Params) (any, error)

Reviews calls the googleplay-reviews operation.

func (*Client) Search

func (c *Client) Search(ctx context.Context, params Params) (any, error)

Search calls the googleplay-search operation.

func (*Client) Similar

func (c *Client) Similar(ctx context.Context, params Params) (any, error)

Similar calls the googleplay-similar operation.

func (*Client) Suggest

func (c *Client) Suggest(ctx context.Context, params Params) (any, error)

Suggest calls the googleplay-suggest operation.

type Params

type Params map[string]any

Params maps the exact OpenAPI parameter names expected by this platform client.