REST API reference

Base URL: https://seobacklinkoworld.online/api/v1
All requests and responses are JSON. Create a key under API keys.

Quick start

  1. Open API keys, create a key and copy it (it is shown once).
  2. Send URLs: POST /urls/bulk with {"urls": [...]}. The answer contains a submission_id.
  3. Poll GET /jobs/{submission_id} every 10–30 seconds until status is completed, then read GET /reports/{submission_id}.

Authentication

Send the key in the Authorization header (or as X-Api-Key). Keys look like ip_xxxxxxxxxxxx_…; only a hash is stored and keys can be revoked any time.

Authorization: Bearer ip_1a2b3c4d5e6f_0123456789abcdef0123456789abcdef01234567

Errors & rate limits

Errors use HTTP status codes and a JSON body: {"error":"validation_failed","message":"…","errors":{"field":"reason"}}.

CodeMeaning
401Missing, invalid or revoked key
403Not allowed (plan feature, or an indexer endpoint with a non-admin key)
404Not found or not yours
409Conflict (e.g. cancelling a finished submission)
422Validation failed (including more URLs than the batch limit; lists are never cut silently)
429Rate limit exceeded; wait Retry-After seconds

Every response carries X-RateLimit-Limit and X-RateLimit-Remaining (requests per minute, per key).

Try it live

Requests made here are real and count like any other API call.

POST/urls— submit one URL

curl -X POST https://seobacklinkoworld.online/api/v1/urls -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page/","wordpress":true,"google":true,"anchor_text":"Our guide"}'
{"data":{"submission_id":1042,"queued":1,"invalid":[],"duplicates":0,"overflow":0,"status":"processing","status_url":"https://seobacklinkoworld.online/api/v1/jobs/1042"}}

Optional fields: name, wordpress (default true; links are placed only when WordPress placement is switched on), google (default true), anchor_text.

POST/urls/bulk— submit many URLs

urls is an array of strings or one newline-separated string. Duplicates are removed; invalid entries are returned (not queued). Plan batch/daily limits and credits apply (administrator accounts have none).

curl -X POST https://seobacklinkoworld.online/api/v1/urls/bulk -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"November posts","urls":["https://example.com/a/","https://example.com/b/","not a url"]}'
{"data":{"submission_id":1043,"queued":2,"invalid":[{"raw":"not a url","reason":"Contains whitespace or control characters"}],"duplicates":0,"overflow":0,"status":"processing","status_url":"https://seobacklinkoworld.online/api/v1/jobs/1043"}}

GET/jobs/{submission_id}— status of a submission

{"data":{"id":1043,"status":"google","stage":5,"total_urls":2,"processed_urls":2,"failed_urls":0,"summary":{"fetched":2,"redirects":0,"noindex":0,"sitemap":1,"google_indexed":0,"google_unknown":2,"wp_inserted":0},"status_counts":{"fetched":2}}}

Status: processing → discovery → google → wordpress → completed, plus paused and cancelled. stage is the workflow stage (3–7).

GET/urls— list your URLs

Query: submission_id, status (e.g. fetched, http_error, noindex_detected), google_status (indexed, not_indexed, unknown), wp_status (inserted, pending, …), q (search), page, per_page (≤ 100). Returns data plus meta.

GET/urls/{id}— full report for one URL

{"data":{"id":9001,"url":"https://example.com/a/","status":"fetched","status_label":"Successfully Fetched","final_url":"https://example.com/a/","http_status":200,"title":"A page","canonical_match":true,"is_noindex":false,"robots":{"platform_allowed":true,"googlebot_allowed":true},"discovery":{"sitemap":true,"feed":false,"internal_link":true},"google":{"status":"indexed","verdict":"PASS","coverage":"Submitted and indexed"},"wordpress":{"status":"inserted","insertion_id":77},"history":[…],"inspections":[…],"recommendations":[…]}}

google.status is only indexed / not_indexed after a verified URL Inspection API response; otherwise unknown.

GET/submissions— your submissions

Query: page, per_page (≤ 100), status.

POST/submissions/{id}/retry— re-queue failed URLs

{"data":{"submission_id":1043,"requeued":3,"status_url":"https://seobacklinkoworld.online/api/v1/jobs/1043"}}

POST /submissions/{id}/cancel stops all pending work: {"data":{"submission_id":1043,"status":"cancelled"}} (409 if already finished).

GET/reports/{submission_id}— full report

?format=json (default) returns the submission, summary and every URL. ?format=txt downloads a plain list; ?format=csv and ?format=xlsx download the full report as CSV or Excel (every plan; plans with advanced reports also get the technical columns).

curl -o report.csv "https://seobacklinkoworld.online/api/v1/reports/1043?format=csv" -H "Authorization: Bearer $KEY"

GET/me— account, plan and limits

{"data":{"id":1,"name":"Owner","email":"[email protected]","phone":"+923001234567","plan":"Admin","limits":{"unlimited":true,"daily_urls":null,"batch_urls":50000,"csv_upload":true},"credits":100000000,"used_today":140}}

GET/usage— usage and credits

{"data":{"plan":"Pro","daily_limit":2000,"used_today":140,"remaining_today":1860,"credits":58210,"history":[{"usage_date":"2026-11-12","urls_submitted":140,"api_requests":12}],"api_requests":[…]}}

GET/wordpress/insertions— where your links were placed

Query: status, submission_id, page.

{"data":[{"id":77,"target_url":"https://example.com/a/","status":"success","status_label":"Successfully Added","site":"Main blog","wp_post_id":415,"post_title":"Resources","post_url":"https://blog.example.com/resources/","anchor_text":"A page","format":"anchor","nofollow":false,"links_in_post":4,"inserted_at":"2026-11-12 10:00:00","error":null,"submission_id":1043}],"meta":{"page":1,"per_page":50,"total":1,"pages":1}}

Ahrefs Indexer administrator keys

Manage your own WordPress sites and send URLs that should be placed on them (same as the Ahrefs Indexer page).

GET/indexer/sites— your indexer sites

{"data":[{"id":3,"name":"My blog","site_url":"https://my-blog.com","status":"connected","enabled":true,"auto_approve":true,"posts_published":24,"posts_ready":24,"links_placed":180,"links_today":12,"links_waiting":3,"last_sync_at":"2026-11-13 09:40:00","last_test":"Connected as editor"}]}

POST/indexer/sites— add a WordPress site

curl -X POST https://seobacklinkoworld.online/api/v1/indexer/sites -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"site_url":"https://my-new-blog.com","username":"editor","app_password":"abcd efgh ijkl mnop qrst uvwx","auto_approve":true}'

Tests the connection and synchronises published posts. 201 when connected, 202 when saved but the test failed (see message).

POST/indexer/sites/bulk— add many WordPress sites at once

curl -X POST https://seobacklinkoworld.online/api/v1/indexer/sites/bulk -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"sites":[{"url":"https://blog-one.com","username":"admin","app_password":"abcd efgh ijkl mnop qrst uvwx"},
               {"url":"https://blog-two.com","username":"admin","app_password":"wxyz 1234 abcd 5678 efgh ijkl","name":"Travel blog"}],
       "auto_approve":true}'

Or send {"text":"https://blog-one.com | admin | abcd efgh ijkl mnop qrst uvwx\n…"} — one site per line, same format as the Bulk add box. Up to 200 sites per call. A site that already exists gets the new login. Answers 202; connection tests and post sync run in the background (see GET /indexer/sites).

{"data":{"added":2,"updated":0,"failed":0,"results":[{"line":1,"site":"https://blog-one.com","status":"added","message":"Added — connection test queued","id":7},{"line":2,"site":"https://blog-two.com","status":"added","message":"Added — connection test queued","id":8}],"note":"…"}}

DELETE/indexer/sites/{id}— remove a site

Clients that cannot send DELETE can use POST /indexer/sites/{id}/delete. Links already placed stay in the site's posts.

POST/indexer/submit— process URLs and place them on your sites

curl -X POST https://seobacklinkoworld.online/api/v1/indexer/submit -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com/backlink-1/","https://example.org/guest-post/"],"anchor_text":"Read more"}'
{"data":{"submission_id":1050,"queued":2,"invalid":[],"duplicates":0,"placement_enabled":true,"status_url":"https://seobacklinkoworld.online/api/v1/jobs/1050"}}

Code examples

Submit a list, wait for the result, print every URL's status.

<?php
$base = 'https://seobacklinkoworld.online/api/v1';
$key  = getenv('INDEXPULSE_KEY');
function api(string $method, string $path, ?array $body = null): array {
    global $base, $key;
    $ch = curl_init($base . $path);
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $key, 'Content-Type: application/json', 'Accept: application/json'],
        CURLOPT_POSTFIELDS => $body ? json_encode($body) : null]);
    $res = json_decode((string)curl_exec($ch), true);
    curl_close($ch);
    return $res;
}
$job = api('POST', '/urls/bulk', ['urls' => ['https://example.com/a/', 'https://example.com/b/']])['data'];
do { sleep(15); $s = api('GET', '/jobs/' . $job['submission_id'])['data']; } while ($s['status'] !== 'completed');
foreach (api('GET', '/reports/' . $job['submission_id'])['data']['urls'] as $u) {
    echo $u['url'], ' → ', $u['status_label'], ' / Google: ', $u['google']['status'], PHP_EOL;
}
import os, time, requests
BASE = "https://seobacklinkoworld.online/api/v1"
H = {"Authorization": "Bearer " + os.environ["INDEXPULSE_KEY"]}
job = requests.post(f"{BASE}/urls/bulk", json={"urls": ["https://example.com/a/", "https://example.com/b/"]}, headers=H).json()["data"]
while requests.get(f"{BASE}/jobs/{job['submission_id']}", headers=H).json()["data"]["status"] != "completed":
    time.sleep(15)
for u in requests.get(f"{BASE}/reports/{job['submission_id']}", headers=H).json()["data"]["urls"]:
    print(u["url"], "→", u["status_label"], "/ Google:", u["google"]["status"])
const BASE = "https://seobacklinkoworld.online/api/v1";
const H = { Authorization: `Bearer ${process.env.INDEXPULSE_KEY}`, "Content-Type": "application/json" };
const api = async (method, path, body) => (await fetch(BASE + path, { method, headers: H, body: body && JSON.stringify(body) })).json();
const { data: job } = await api("POST", "/urls/bulk", { urls: ["https://example.com/a/", "https://example.com/b/"] });
while ((await api("GET", `/jobs/${job.submission_id}`)).data.status !== "completed") await new Promise(r => setTimeout(r, 15000));
for (const u of (await api("GET", `/reports/${job.submission_id}`)).data.urls) console.log(u.url, "→", u.status_label);
KEY=ip_your_key
ID=$(curl -s -X POST https://seobacklinkoworld.online/api/v1/urls/bulk -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com/a/","https://example.com/b/"]}' | sed -E 's/.*"submission_id":([0-9]+).*/\1/')
curl -s https://seobacklinkoworld.online/api/v1/jobs/$ID -H "Authorization: Bearer $KEY"
curl -s -o report.txt "https://seobacklinkoworld.online/api/v1/reports/$ID?format=txt" -H "Authorization: Bearer $KEY"

Notes

  • Google fields come only from verified URL Inspection API responses; otherwise google.status is unknown.
  • WordPress placement runs after processing; the final report includes the post details.
  • Nothing in this API guarantees indexing: crawling and indexing are decided by search engines and crawlers.