---
updatedAt: 2026-06-22T12:55:13.000Z
agentTools:
  projectIndex: https://docs.api.appfollow.io/llms.txt
---

# Aso Keyword Research

<strong>Price</strong>: 5 credits per request

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "servers": [
    {
      "url": "https://api.appfollow.io",
      "description": "Production Server"
    }
  ],
  "info": {
    "version": "1.2.0",
    "title": "AppFollow API",
    "description": "Some long description for AppFollow public API\n\n# Authentication\n<SecurityDefinitions />\n",
    "termsOfService": "https://appfollow.io/en/terms",
    "contact": {
      "name": "AppFollow.fi Oy",
      "url": "https://appfollow.io/en",
      "email": "hi@appfollow.io"
    }
  },
  "x-readme": {
    "samples-languages": [
      "curl"
    ]
  },
  "x-tagsOrder": [
    "General",
    "Users",
    "Reviews",
    "Reviews Stats",
    "Replies",
    "Ratings",
    "App Metadata",
    "Rankings",
    "Featured",
    "ASO Research",
    "ASO Reports",
    "Keywords",
    "Downloads And Revenue"
  ],
  "components": {
    "schemas": {
      "HTTPValidationError": {
        "title": "HTTPValidationError",
        "type": "object",
        "properties": {
          "detail": {
            "title": "Detail",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            }
          }
        }
      },
      "ValidationError": {
        "title": "ValidationError",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "type": "object",
        "properties": {
          "loc": {
            "title": "Location",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "api_key": {
        "description": "some api key desc",
        "type": "apiKey",
        "name": "X-AppFollow-API-Token",
        "in": "header"
      }
    }
  },
  "paths": {
    "/api/v2/aso/suggests": {
      "get": {
        "tags": [
          "ASO Research"
        ],
        "summary": "Aso Keyword Research",
        "description": "<strong>Price</strong>: 5 credits per request",
        "operationId": "ASO_Keyword_Research_api_v2_aso_suggests_get",
        "parameters": [
          {
            "description": "Keyword",
            "required": true,
            "schema": {
              "title": "Term",
              "type": "string",
              "description": "Keyword"
            },
            "example": "messenger",
            "name": "term",
            "in": "query"
          },
          {
            "description": "Country code",
            "required": false,
            "schema": {
              "title": "Country",
              "type": "string",
              "description": "Country code"
            },
            "example": "us",
            "name": "country",
            "in": "query"
          },
          {
            "description": "Device code",
            "required": false,
            "schema": {
              "title": "Device",
              "type": "string",
              "description": "Device code"
            },
            "example": "iphone",
            "name": "device",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Invalid API token."
              }
            }
          },
          "402": {
            "description": "Payment Required",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Not enough credits."
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "424": {
            "description": "Failed Dependency",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Check you settings: {dependency}"
              }
            }
          }
        },
        "security": [
          {
            "api_key": [
              "read"
            ]
          }
        ]
      }
    }
  }
}
```