REST API reference
Base URL: https://seobacklinkoworld.online/api/v1
All requests and responses are JSON. Create a key under API keys.
Quick start
- Open API keys, create a key and copy it (it is shown once).
- Send URLs:
POST /urls/bulkwith{"urls": [...]}. The answer contains asubmission_id. - Poll
GET /jobs/{submission_id}every 10–30 seconds untilstatusiscompleted, then readGET /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"}}.
| Code | Meaning |
|---|---|
| 401 | Missing, invalid or revoked key |
| 403 | Not allowed (plan feature, or an indexer endpoint with a non-admin key) |
| 404 | Not found or not yours |
| 409 | Conflict (e.g. cancelling a finished submission) |
| 422 | Validation failed (including more URLs than the batch limit; lists are never cut silently) |
| 429 | Rate 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.statusisunknown. - 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.