Inlinks’ SEO APIs (Application Programming Interfaces) allow developers to access cutting edge SEO analysis and embed them in their own softwares and services. These APIs are updated on a daily basis to take into account Knowledge Graphs changes and InLinks latest developments.

Inlinks currently provides 2 types of SEO APIs:

These APIs are available to all Inlinks users having a level 4+ subscription.

Supported languages are English, French and Spanish.

1. Search Engine Understanding and NLP API

This API lets you send a URL to get:

  • The list of entities detected by Inlinks
  • The entities detected by Google
  • The category or type of each entity
  • The Search Engine Understanding score
  • A Semantic Schema markup you can add in a webpage to ensure Google correctly understands the entities you’re talking about.

How to start using the API

  1. Go to your Inlinks Dashboard > My account and grab your api key and your customer id
  2. call the API as follows (PHP example) :

Input Code

$url = 'https://example.com/url-you-want-to-analyse/' ; 
$apiKey = YOUR_API_KEY ;
$customer_id = YOUR_CUSTOMER_ID ; 
$apiURL = 'https://inlinks.net/api/seu.php?api_key='.$apiKey.'&url='.$url.'&cid='.$customer_id;
  
$curl_handle=curl_init();
curl_setopt($curl_handle, CURLOPT_URL,$apiURL);
curl_setopt($curl_handle, CURLOPT_CONNECTTIMEOUT, 8);
curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl_handle, CURLOPT_FOLLOWLOCATION, true);
$data = json_decode(curl_exec($curl_handle));
curl_close($curl_handle) ;

API Response

$entities = $data->entities ; // returns an array of entities objects
$seu_score   = $data->seu_score ;     // returns the SEU score
$message     = $data->message ;      // returns a message in case of problem
$httpStatus  = $data->status ;  // Response status. 200 if OK
$schema     = $data->schema ;   // Semantic Schema in JSON format

Here is what an entity object looks like

$entity = object(stdClass) {
      ["word"] => "detected word",
      ["entity"] => "corresponding entity",
      ["entityID"] => "364978", // Entity ID or null
      ["sameAs"] => "absolute wikipedia URL",
      ["category"]= > "Entity category",
      ["weight"] => "1", // Nb of times the entity has been detected
      ["detected"] => 1  // 1 if detected by Google, 0 if not
}

Main API characteristics & Cost

  • The API is synchroneous but may take a few seconds to provide the response.
  • Rate limitation is 1 call every 5 seconds. Enterprise Plan users don’t have any rate limitation.
  • An API call costs 1 credit.

API Error codes

If the API call is successfull, the API response status is 200. Otherwise, one of the following error codes can be returned:

  • 204: No Content or Enable to access/analyse the content
  • 400: Invalid Parameter (customer_id)
  • 401: Invalid API key
  • 402: Payment Required
  • 415: Unsupported Language
  • 429: Too Many Requests (rate limitation exceeded)

2. Content Audit API

This API lets you get a white-label SEO content audit, similar to Inlinks Content Audit tool.

An API call requires the following parameters:

  • The keyword or phrase to audit
  • The selected language/market (see list below)
  • The selected Search Engine
  • An existing URL to audit (optional)
  • Your Customer ID and associated API key

The output of this API is a web page, not XML. If the call is successful, the API returns the URL of the Content Audit.

How to start using the API

  1. Go to your Inlinks Dashboard > My account and grab your api key and your customer id
  2. Upload your own logo in your My account page
  3. Call the API as follows (PHP example) :

Input Code

/* Markets List
FR-FR // French – France
FR-CA // French – Canada
FR-BE // French – Belgium
EN-US // English – United States
EN-UK // English – UK
EN-CA // English – Canada
EN-AU // English – Australia
EN-IN // English – India
EN-NZ // English – New Zealand
EN-ZA // English – SOuth Africa
EN-IE // English – Ireland
EN-SG // English – Singapore
EN-MY // English – Malaysia
ES-ES // Spanish – Spain
ES-EV // Spanish – Venezuela
ES-AR // Spanish – Argentina
ES-CO // Spanish – Columbia
ES-GT // Spanish – Guatemala
ES-CR // Spanish – Costa Rica
ES-DO // Spanish – Dominican Republic
ES-PE // Spanish – Peru
ES-MX // Spanish – Mexico
ES-UY // Spanish – Uruguay

// Input Parameters
$searchType = 1 ; // 1 = Google Search // 2= Bing News ;
$keyword = ‘YOUR KEYWORD’ ; // Shall be URL encoded
$customer_id = ‘YOUR CUSTOMER ID’ ;
$api_key = ‘YOUR API KEY’ ;
$market = ‘EN-US’ ; // see market list above

$refURL = ‘URL TO AUDIT’ ; // LEFT BLANK FOR A CONTENT BRIEF 

$doc = array();
$doc[‘keyword’] = $keyword ;
$doc[‘urls’] = $urls ;
$doc[‘market’] = $market ;
$doc[‘cid’] = $customer_id ;
$doc[‘search’] = $searchType ;
$doc[‘refURL’] = $refURL ;

$payload = json_encode($doc) ;

$url = ‘https://inlinks.net/api/brief?key=’ . $api_key . ‘&payload=’ .$payload ;

$ch = curl_init(); 
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(‘Content-Type:application/json’));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$results = json_decode(curl_exec($ch));
curl_close ($ch);

API Response

$httpStatus = $results->code ; // 200: OK
$auditURL = $results->msg ; // Content Audit URL

Main API characteristics

  • The Content Audit API is synchronous but the Final Content Audit may take up to 2 minutes to show up.
  • No rate limitation
  • An API call costs 5 credits + 1 credit if an URL is submitted.

API Error codes

If the API call is successfull, the API response status is 200. Otherwise, one of the following error codes can be returned:

  • 204: No Content or Enable to access/analyse the content
  • 400: Invalid Parameter
  • 401: Invalid API key
  • 402: Payment Required