// Documentation

DataToRank
SEO API

REST API for automatic generation of AI-powered SEO content for e-commerce. Powered by Groq + LLaMA 3.3 70B, returns structured JSON in under one second.

REST API per la generazione automatica di contenuti SEO con AI. Powered by Groq + LLaMA 3.3 70B, risposta JSON in meno di un secondo.

Base URL https://datatorank.com

Response format All responses are application/json. The field success: true indicates a valid response. Output language is configured per API key.

Authentication

Autenticazione

Every request must include your API key. You can send it in two ways.

Ogni richiesta deve includere la tua API key. Puoi inviarla in due modi.

Method 1 — HTTP Header (recommended)

HTTP Header

X-API-Key: dtr_a8f3c91d4b2e7f1a

Method 2 — URL parameter

URL

https://datatorank.com/seo/ai/description?api_key=dtr_a8f3c91d4b2e7f1a&text=product_name

Keep your key safe. Never include it in public code or Git repositories. Always use it server-side.Non includerla mai in codice pubblico o repository Git. Usala sempre lato server.

Error handling

The API uses standard HTTP codes. In case of error, the JSON always contains a descriptive error field.

L'API usa codici HTTP standard. In caso di errore, il JSON contiene sempre un campo error descrittivo.

200

OK — Request processed successfully.

401

Unauthorized — API key missing or invalid.

429

Too Many Requests — Credits exhausted. Upgrade your plan.

500

Server Error — Internal error. Contact info@myapikey.com if it persists.

Error response
{
  "success": false,
  "error":   "Invalid API Key"
}

// Endpoint 1

Generate SEO description

GET /seo/ai/description

Generates SEO title (max 60 chars), high-CTR meta description (max 160 chars) and 4 bullet points for the product page.

Genera titolo SEO (max 60 car.), meta description ad alta CTR (max 160 car.) e 4 bullet point per la scheda prodotto.

Parameters

Parameter	Type	Required	Description
text	string	required	Product name to optimize.
api_key	string	optional	Alternative to X-API-Key header.

Example request

cURL

curl https://datatorank.com/seo/ai/description \
  -H "X-API-Key: dtr_a8f3c91d4b2e7f1a" \
  -G --data-urlencode "text=Nike Air Max 90 White Sneakers"

Response

JSON
{
  "success": true,
  "data": {
    "title":       "Nike Air Max 90 White | Iconic Comfort & Style",
    "description": "Discover Nike Air Max 90 White: timeless design with visible Air technology.",
    "bullets": [
      "Visible Air Max cushioning for superior shock absorption",
      "Breathable mesh upper for all-day comfort",
      "High-durability rubber outsole",
      "Iconic 90s design with a modern edge"
    ]
  }
}

// Endpoint 2

Generate keywords

GET /seo/ai/keywords

Returns primary high-volume keywords, high-conversion long-tail keywords and negative keywords. Perfect for product pages and Google Ads campaigns.

Restituisce keyword primarie, long-tail ad alta conversione e keyword negative. Perfetto per schede prodotto e campagne Google Ads.

Parameters

Parameter	Type	Required	Description
text	string	required	Product name or category to analyze.

Response

JSON
{
  "success": true,
  "data": {
    "primary": ["nike air max 90", "air max 90 white", "nike sneakers men"],
    "related":  ["nike air max 90 white size 44", "retro 90s nike shoes"],
    "negative": ["used", "replica", "fake"]
  }
}

// Endpoint 3

Full package

GET /seo/ai/full

The most powerful endpoint. In a single call you get: title, meta description, bullet points, keywords and Schema JSON-LD ready to inject into your page head for Google Rich Results.

L'endpoint più potente. In una sola chiamata: titolo, meta, bullet, keyword e Schema JSON-LD pronto per i Google Rich Results.

Available from Pro plan.Disponibile dal piano Pro. One call replaces 3 separate requests.Una chiamata sostituisce 3 richieste separate.

Response

JSON
{
  "success": true,
  "data": {
    "title":        "Nike Air Max 90 White | Iconic Comfort & Style",
    "description":  "Timeless design with visible Air technology.",
    "bullet_points": ["Visible Air cushioning", "..."],
    "keywords": {
      "primary": ["nike air max 90", "..."],
      "related":  ["nike air max 90 white men 44", "..."]
    },
    "schema": {
      "@context":    "https://schema.org",
      "@type":       "Product",
      "name":        "Nike Air Max 90 White",
      "description": "Iconic Nike sneakers with visible Air technology.",
      "offers": {
        "@type":         "Offer",
        "priceCurrency": "EUR",
        "availability":  "https://schema.org/InStock"
      }
    }
  }
}

// Integration examples

cURL

Bash

curl https://datatorank.com/seo/ai/description \
  -H "X-API-Key: dtr_your_key" \
  -G --data-urlencode "text=Your product name" | python3 -m json.tool

PHP

$apiKey   = 'dtr_your_key';
$product  = 'Nike Air Max 90 White';
$url      = 'https://datatorank.com/seo/ai/description?text=' . urlencode($product);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: ' . $apiKey]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

$title       = $response['data']['title'];
$description = $response['data']['description'];
$bullets     = $response['data']['bullets'];

JavaScript (Node.js)

JavaScript

// Server-side only — never expose the key client-side
const res = await fetch(
  `https://datatorank.com/seo/ai/full?text=${encodeURIComponent('Nike Air Max 90')}`,
  { headers: { 'X-API-Key': 'dtr_your_key' } }
);
const { data } = await res.json();

console.log(data.title);    // SEO title
console.log(data.keywords); // Primary and long-tail keywords
console.log(data.schema);   // JSON-LD ready to inject

Python

import requests

res = requests.get(
    "https://datatorank.com/seo/ai/keywords",
    headers={"X-API-Key": "dtr_your_key"},
    params={"text": "Nike Air Max 90 White"}
)
data = res.json()["data"]
print(data["primary"])   # primary keywords
print(data["related"])   # long-tail
print(data["negative"])  # negative keywords

// Plans & Limits

Rate limits & credits

Each plan has a fixed number of monthly optimizations. Every API call uses 1 credit. Purchase a new plan to continue.

Ogni piano ha un numero fisso di ottimizzazioni mensili. Ogni chiamata API usa 1 credito. Acquista un nuovo piano per continuare.

Starter

€19

150 opt / month150 ott / mese

/description endpointEndpoint /description
Meta title + description + slug
1 site1 sito

Pro ★

€49

600 opt / month600 ott / mese

All endpointsTutti gli endpoint
300+ word descriptionsDescrizioni 300+ parole
Alt texts + Schema JSON-LD
1 site1 sito

Business

€129

2,000 opt / month2.000 ott / mese

All endpointsTutti gli endpoint
Batch Processor includedBatch Processor incluso
3 sites3 siti

Agency

€299

6,000 credits / month6.000 crediti / mese

All endpointsTutti gli endpoint
Unlimited sitesSiti illimitati
White-label exportExport white-label

Annual plans save up to 33%. Piani annuali con fino al 33% di sconto. View full pricing → Vedi tutti i prezzi →

DataToRankSEO API

Authentication

Autenticazione

Method 1 — HTTP Header (recommended)

Method 2 — URL parameter

Error handling

Generate SEO description

Parameters

Example request

Response

Generate keywords

Parameters

Response

Full package

Response

cURL

PHP

JavaScript (Node.js)

Python

Rate limits & credits

DataToRank
SEO API