Activating Your API Access

Once your MAPEGY API account is created, you will receive an email containing a link to activate your credentials. 

Just click the activation link provided in the email, and save your client_id and client_secret in a secure Password Manager.

Your credentials allow you to access all API services (Autosuggest, Panel, and Document API)  that we have activated for your account.
If you need to replace your credentials, please contact our support team. Note that previously activated credentials will automatically expire one month after new credentials are issued.

‍

Testing

Once your credentials are activated, you can explore the API through two key resources:

• API demo page: View and test activated API routes, enter parameters, execute requests, and download example scripts for integration.
• Panel API demo page: Showcases advanced integration features and available panels.

Learn more about testing here. 

‍

Authentication and token generation

To authenticate and interact with the API, get a token using your credentials (client_id and client_secret).
This token will expire after a few hours. Shortly before expiration, you should request a new token. Be aware that requests with expired tokens can lead to temporary IP lockouts.

• Route: /Auth/get-token/
• Method: POST
• Content-Type: application/x-www-form-urlencoded
• Mandatory Parameters: client_id, client_secret‍
• Example response: 

{
  "token_type": "bearer",
  "access_token": "fr9Ch_2BDFI-rBR6edo0Lb-0JRVP6lBb5Fb7p4FYND0Xnlk_2NpNNcJ1IAYlO3SL",
  "expires_in": 7200,
  "expiration_timestamp": 1738843401,
  "available_apis": [
    "Panel API",
    "Autosuggest API",
    "Documents API"
  ]
}