NAV Navbar
shell
  • Introduction
  • Authentication
  • Tracking URL Check
  • Errors
  • Introduction

    Welcome to the GoTrace API! You can use our API to access GoTrace API endpoints.

    You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

    Authentication

    Firstly, you have to get an API key from GoTrace dashboard to use GoTrace API.

    https://gotrace.io/integrations

    To make an authorized request , use this code:

    # With shell, you can just pass the correct header with each request
    curl "api.gotrace.io/your_endpoint"
      -H "Authorization: {{API_KEY}}"
    

    Make sure to replace {{API_KEY}} with your API key.

    GoTrace expects for the API key to be included in all API requests to the server in a header that looks like the following:

    Authorization: {{API_KEY}}

    Tracking URL Check

    Check a single Tracking URL

    POST https://api.gotrace.io/check

    To check a single tracking url, use this code:

    curl -X POST 
      -H "Authorization: {{API_KEY}}"
      -d  '{"country":"de","platform":"ios","tracking_url":{{TRACKING_URL}}' 
      "https://api.gotrace.io/check"
    

    Make sure to replace {{API_KEY}} with your API key and {{TRACKING_URL}} with a proper tracking url.

    This endpoint requires following parameters as JSON encoded string at its http body

    JSON Fields

    Parameter Description
    tracking_url tracking url to check
    country ISO Alpha-2 code of the specified country
    platform "ios" or "android"

    Check multiple Tracking URLs

    POST https://api.gotrace.io/check

    Same endpoint is used for checking both single and multiple urls , you must provide an array of tracking urls in order to check multiple tracking urls. GoTrace API allows up to 5 tracking urls simultaneously.

    To check multiple tracking urls, use this code:

    curl -X POST 
      -H "Authorization: {{API_KEY}}"
      -d  '[{"country":"de","platform":"ios","tracking_url":{{TRACKING_URL}}},{"country":"br","platform":"ios","tracking_url":{{TRACKING_URL}}}]' 
      "https://api.gotrace.io/check"
    

    Make sure to replace {{API_KEY}} with your API key and {{TRACKING_URL}} with a proper tracking url.

    Errors

    Error Code Meaning
    AUTH_ERROR Your API key is not valid
    CREDIT_NOT_ENOUGH You don't have any credit left.
    PROVIDE_A_VALID_JSON Your request body is not a valid JSON
    MISSING_PARAMETER Your JSON is miissing a mandatory field.
    INVALID_VALUE There is a type mismatch or an invalid value
    TOO_MANY_URLS_TO_CHECK You have provided too many tracking urls (as of now limit is 5)