influData Insights & Discovery Bot

influData Insights & Discovery Bot · Acciones GPT

Get user data

Retrieves data for a specific user on a platform.

  • GET /getUserDataGetUserData

    Get data for a specific user on a platform

  • POST /sendMailAndCompanyNameSendMailAndCompanyName

    Send the email and company name from the user to influData server

  • GET /discoverydiscovery

    Get discovery data from influData, so searching for a large number of influencers by parameters

Esquema original API
{
  "openapi": "3.1.0",
  "info": {
    "title": "Get user data",
    "description": "Retrieves data for a specific user on a platform.",
    "version": "v1.0.0"
  },
  "servers": [
    {
      "url": "https://app.infludata.com/api/externalAPI"
    }
  ],
  "paths": {
    "/getUserData": {
      "get": {
        "description": "Get data for a specific user on a platform",
        "operationId": "GetUserData",
        "parameters": [
          {
            "name": "username",
            "in": "query",
            "description": "The username to retrieve data for. Only for youtube request, add http://www.youtube.com/@ + the username. Do not add anything for instagram and tiktok",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "description": "The platform of the user, either instagram, tiktok or youtube. if nothing specified, then instagram is used.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientId",
            "in": "query",
            "description": "The clientId is always 123456",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "showDatalogAndScore",
            "in": "query",
            "description": "This has always value true",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "deprecated": false
      }
    },
    "/sendMailAndCompanyName": {
      "post": {
        "description": "Send the email and company name from the user to influData server",
        "operationId": "SendMailAndCompanyName",
        "parameters": [
          {
            "name": "email",
            "in": "body",
            "description": "The email that is provided",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "company",
            "in": "body",
            "description": "The company name that is provided",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientId",
            "in": "body",
            "description": "The clientId is always 123456",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "deprecated": false
      }
    },
    "/discovery": {
      "get": {
        "description": "Get discovery data from influData, so searching for a large number of influencers by parameters",
        "operationId": "discovery",
        "parameters": [
          {
            "name": "sorting",
            "in": "query",
            "description": "The sorting by default should be followers. Possible values are relevance (for keywords), followers (for biggest influencers), growthRate, engagementMean.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "description": "The value is either tiktok, instagram or youtube.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "followerMin",
            "in": "query",
            "description": "The number of the minimum followers. Send 2000 if not specified",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "followerMax",
            "in": "query",
            "description": "The number of the maximum followers. Send Infinity if not specified.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "growthRate",
            "in": "query",
            "description": "The number of the minimum growth rate. Send percent as a whole number as string",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "engagementRate",
            "in": "query",
            "description": "The number of the minimum engagementRate. Send percent as a whole number as string.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "city",
            "in": "query",
            "description": "The city if specified with first letter uppercase and in English writing. Ensure the English name.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "The country if specified with first letter uppercase and in English writing.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keywords",
            "in": "query",
            "description": "Keywords, like vegan, soccer, etc. or also mentions starting with @username, if the user wants to know who posted about an account. If more keywords are specified, then seperate by comma without spaces. There are no special characters, like dash, dots etc. allowed.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "language",
            "in": "query",
            "description": "Language if specified by two-letter iso-abbreviation e.g. de, en etc.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "gender",
            "in": "query",
            "description": "possible values are 'm' for male or 'w' for female. only send if requested.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientId",
            "in": "query",
            "description": "The clientId is always 123456",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "skipCount",
            "in": "query",
            "description": "The skipCount is not needed for the first page, but will be incremented by 20, so the second page will have a value of 20.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {}
  }
}