Mangools/API

Create new exports task

Create a new full-backlink CSV export job for a target URL, domain or subdomain. The export is generated asynchronously — poll /linkminer/exports to track state and to obtain the downloadURL once the job completes.

Prerequisites

Call POST /linkminer/exports/suggest first for the same URL to determine the available target types and the estimated cost; the export request requires a matching suggestion.

Limits

The export cost is subtracted from your Backlink rows limit.

POST
/linkminer/exports

Authorization

ApiKeyAuth
x-access-token<token>

API token issued for your Mangools account, sent as an API key in the x-access-token HTTP header. This is NOT a standard RFC 6750 Authorization: Bearer <token> header. Auto-generated clients should be configured to send the token in x-access-token accordingly.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.mangools.com/v3/linkminer/exports" \  -H "Content-Type: application/json" \  -d '{    "url": "dsl.sk"  }'
{
  "owner": "string",
  "_id": "5f8d0d55b54764421b7156c3",
  "jobName": "string",
  "state": 600,
  "email": "string",
  "error": "string",
  "request": {
    "url": "mangools.com",
    "type": "RootDomain",
    "limit": 50000,
    "filter": {
      "targetAnchorText": "string",
      "targetHrefText": "string",
      "linkType": "string",
      "noFollow": true,
      "liveLinks": true,
      "minCitationFlow": 0,
      "maxCitationFlow": 0,
      "minTrustFlow": 0,
      "maxTrustFlow": 0,
      "minTopRank": 0,
      "maxTopRank": 0,
      "minLinkStrength": 0,
      "maxLinkStrength": 0,
      "flagTextLink": true,
      "flagImageLink": true,
      "flagFrameLink": true,
      "flagRedirectLink": true,
      "flagMentionLink": true,
      "linksPerDomain": 1
    }
  },
  "stats": {
    "fresh": 0,
    "historic": 0,
    "duplicates": 0,
    "filtered": 0,
    "topRank": {
      "requests": 0,
      "rpcCalls": 0,
      "rpcGoodResult": 0,
      "goodResult": 0,
      "successRate": 0
    },
    "fb": {
      "requests": 0,
      "rpcCalls": 0,
      "rpcGoodResult": 0,
      "goodResult": 0,
      "successRate": 0
    }
  },
  "backLinks": 0,
  "cost": 0,
  "costPrediction": 0,
  "createdAt": 0,
  "completedAt": 0,
  "downloadURL": "https://s3.amazonaws.com/mangools-lm-export/56cac3c2-2880-41a2-9f6d-a5d86364df6c/example.com.csv"
}
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}
{
  "error": {
    "type": "InvalidInput",
    "message": "Parameter url is invalid"
  }
}
{
  "error": {
    "type": "RateLimit",
    "message": "Not enough limits 2"
  }
}