Skip to content
Last updated

Our goal is to help you get started quickly.

If you don't have access to our API products yet, please contact our team:

Together we will:

  • Talk about your API and business needs.
  • Cover all your questions and ideas.
  • Figure out if our API is the right solution for you and your team.
  • Discover our pricing and get your access to the API.

We're ready when you are ⚡

If you are ready to go. Find everything about Authentication, Error codes and Billing below, download our Postman collection and explore all endpoints.

Authentication

All requests to the API must be authenticated.

You can get your access token from https://marketer.modash.io/developer.

Use the access token as:

  • Authorization header field where the value is in the format Bearer {token}
  • or access_token body parameter
  • or access_token query parameter

Error codes

If the API returns errors then the HTTP status code is different from 200 (corresponding 4xx or 5xx code) and error details are formatted as such:

{
	"error": true,
	"code": "…", // documented below
	"message": "…"
}
CodeMessage
api_token_invalidA valid API token is needed. Please visit the account developer section.
bad_requestSearch keyword undefined. Please pass the search keyword id as a query parameter
bad_requestComment id undefined. Please pass the comment id as a query parameter
bad_requestHashtag undefined. Please pass the hashtag as a query parameter
bad_requestMedia shortcode undefined. Please pass the media code as a query parameter
bad_requestUrl query parameter undefined or has a bad format
handle_not_foundNo public account was found by that handle. It's possible the influencer has been removed or has a private account.
account_not_foundRequested account does not exist
account_removedRequested account was removed
media_not_foundMedia ID not found
entity_not_foundRequested entity does not exist
private_accountRequested account is private
empty_audienceWe have no audience for this account.
retry_laterWe don't have audience for this account but will have very soon. Try again in a couple of hours.
not_enough_creditsYou don't have enough credits for this action. Contact us to top up your credits.
internal_server_errorOur server is experiencing problems processing your request. We have been notified and will look into this.
request_timeoutThe server timed out waiting for the request to be completed. Please try again.
client_errorThe request contains bad syntax or cannot be fulfilled. Please check and modify your request accordingly.
invalid_body_paramsYou have sent invalid body parameters. Please verify your request using the documentation.
feature_not_availableThis feature is not available for your account. Contact us for enabling the feature.
no_resultNo result found for this query, try changing filters and please verify your request using the documentation.
page_limitYou have reached the maximum page limit. Please contact support.

Resources might have more documented errors. These will be documented in the responses section in the routes descriptions.

For error handing use the code because messages might change over time without any notice.

Rate Limiting Errors

Rate limiting errors are always with the HTTP status code 429. Please read the HTTP status code and handle the errors accordingly.

Billing for Failed Requests

In case of any failed responses, e.g. HTTP status code 500 (Internal Server Error), we want to assure you that you will not incur any charges or consume any credits/limits. These failed requests are considered non-billable events.



Start exploring our APIs