API reference
Every parameter, response field and error code for all 14 endpoints, with each request written in cURL, Node, Python, PHP and Go.
- Base URL
- https://tabapi.com/api/v1
- Auth
- Bearer sk_…
- Format
- JSON
Quickstart
Three steps from nothing to your first response. Every endpoint on this page works the same way.
- 1
Create a key
Sign in and open Settings → API keys. Keys start with
sk_. - 2
Send it as a bearer token
Put
Authorization: Bearer sk_…on every request tohttps://tabapi.com/api/v1. - 3
Read the resource
A success is the resource itself: no envelope, snake_case fields, ISO 8601 UTC times,
nullwhen a value is unknown. Errors share one shape and are never charged.
curl "https://tabapi.com/api/v1/domains/vercel.com/dns?type=all" \
-H "Authorization: Bearer sk_live_..."{
"domain": "vercel.com",
"status": "NOERROR",
"resolver": "google",
"records": [
{
"type": "A",
"name": "vercel.com.",
"ttl": 143,
"value": "64.239.123.65"
},
{
"type": "A",
"name": "vercel.com.",
"ttl": 143,
"value": "64.239.109.1"
},
{
"type": "MX",
"name": "vercel.com.",
"ttl": 872,
"value": "1 aspmx.l.google.com."
},
{
"type": "MX",
"name": "vercel.com.",
"ttl": 872,
"value": "10 aspmx3.googlemail.com."
},
{
"type": "NS",
"name": "vercel.com.",
"ttl": 21520,
"value": "ns1.vercel-dns.com."
},
{
"type": "NS",
"name": "vercel.com.",
"ttl": 21520,
"value": "ns2.vercel-dns.com."
},
{
"type": "TXT",
"name": "vercel.com.",
"ttl": 1800,
"value": "v=spf1 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com include:mktomail.com include:amazonses.com include:sendgrid.net include:_spf.salesforce.com include:spf.mtasv.net ~all"
}
]
}Authentication
Every request carries a secret key as a bearer token. Keys belong to your account, and every key you create spends the same credit balance.
- Send the key in the
Authorizationheader. A key in the query string is rejected with401 unauthorized, so keys stay out of URLs and logs. - Keep keys on a server you trust. Never ship one in browser or mobile code.
- Create, name and revoke keys in Settings → API keys.
Authorization: Bearer sk_live_...{
"error": {
"code": "unauthorized",
"message": "...",
"status": 401,
"request_id": "req_...",
"docs_url": "https://tabapi.com/docs#error-unauthorized"
}
}Credits & metering
Every successful call costs whole credits, cache hits included. Errors never cost anything.
- $1 buys 1,000 credits. Packs are one-time purchases, and purchased credits never expire. See pricing.
- Variable-cost endpoints state their rule inline: Traffic bills by the months actually returned.
- When the balance is short, a call returns 402 insufficient_credits and nothing is charged.
- Your balance and every metered call are listed in Settings → Credits.
Domain endpoints
Pass a domain or hostname, not a URL. Each endpoint states whether it uses the submitted hostname or its registrable root.
Website Traffic API
3–12 creditsTraffic estimates: monthly visits, engagement, sources, top regions and keywords. Charged by the 3–12 months actually returned.
/ api/ v1/ domains/ {domain}/ trafficParameters
domainstringin pathRequiredDomain or hostname (e.g. vercel.com), not a URL. Normalized to lowercase punycode and looked up as given, not reduced to the registrable root.
Example
vercel.commonthsintegerin queryTrailing months of history to include in monthly_visits. 3-12, default 3; billed by months actually returned.
Default
3
Response
domainstringThe site these figures describe. Usually the requested hostname; a www. hostname returns its root domain.
titlestring | nullSite title.
descriptionstring | nullSite description.
overviewobjectHeadline metrics for the reporting month (overview.month): ranks, visits and behaviour.
global_ranknumber | nullEstimated global traffic rank (lower = more traffic). null if unranked.
country_rankobject | nullRank within the top country (country + rank travel together). null if unranked.
visitsnumber | nullEstimated total visits in the month.
bounce_ratenumber | nullBounce rate as a fraction 0-1.
pages_per_visitnumber | nullAverage pages viewed per visit.
time_on_site_secondsnumber | nullAverage session duration, in seconds.
monthstring | nullThe month this overview represents, "YYYY-MM".
monthly_visitsarrayMonthly visit history, ascending, up to
monthsentries.monthstring"YYYY-MM".
visitsnumberEstimated visits that month.
traffic_sourcesobjectShare of traffic by channel (fractions summing ~1), full fidelity: direct, search (+organic/paid), social (+organic/paid), referrals, paid_referrals, mail, gen_ai, affiliate, other. All 13 keys always present; null when unknown.
top_keywordsarrayTop organic keywords.
namestringKeyword text.
volumenumberMonthly search volume.
cpcnumberEstimated cost-per-click, in USD.
estimated_valuenumberEstimated monthly traffic value, in USD.
top_regionsarrayTop visitor countries.
countrystringISO alpha-2 country code.
namestringEnglish country name.
sharenumberShare of visitors, fraction 0-1.
ai_trafficobject | nullAI-assistant referral trends (e.g. ChatGPT); null when unavailable.
trendsarrayOne entry per AI assistant.
namestringThe assistant’s site, e.g. "chatgpt.com".
historyarrayMonthly points in upstream order (newest first today); sort by date before charting.
datestringFirst day of the month, "YYYY-MM-DD".
valuenumberThis assistant’s share of AI-assistant referrals, as a percent 0-100.
Errors: invalid_domain (400), insufficient_credits (402), unprocessable (422 when fewer than 3 months are available), upstream_error (502). See error codes.
curl "https://tabapi.com/api/v1/domains/vercel.com/traffic?months=3" \
-H "Authorization: Bearer sk_live_..."{
"domain": "vercel.com",
"title": "Agentic Infrastructure - Vercel",
"description": "The autonomous stack for every app and agent.",
"overview": {
"global_rank": 1379,
"country_rank": {
"country": "US",
"rank": 1751
},
"visits": 30173255,
"bounce_rate": 0.3183140837117228,
"pages_per_visit": 6.51107996645392,
"time_on_site_seconds": 428.8698635560867,
"month": "2026-08"
},
"monthly_visits": [
{
"month": "2026-06",
"visits": 28727146
},
{
"month": "2026-07",
"visits": 30777447
},
{
"month": "2026-08",
"visits": 30173255
}
],
"traffic_sources": {
"direct": 0.7092,
"search": 0.1347,
"search_organic": 0.129,
"search_paid": 0.0057,
"social": 0.0452,
"social_organic": 0.0449,
"social_paid": 0.0003,
"referrals": 0.0665,
"paid_referrals": 0.0026,
"mail": 0.0178,
"gen_ai": 0.024,
"affiliate": 0,
"other": 0
},
"top_keywords": [
{
"name": "vercel",
"volume": 2802320,
"cpc": 1.1,
"estimated_value": 2800450
},
{
"name": "vercel login",
"volume": 81130,
"cpc": 1.89,
"estimated_value": 110590
}
],
"top_regions": [
{
"country": "US",
"name": "United States",
"share": 0.1998
},
{
"country": "IN",
"name": "India",
"share": 0.1482
},
{
"country": "GB",
"name": "United Kingdom",
"share": 0.0422
}
],
"ai_traffic": {
"trends": [
{
"name": "chatgpt.com",
"history": [
{
"date": "2026-08-01",
"value": 71.70603131544368
},
{
"date": "2026-07-01",
"value": 53.523337061264655
},
{
"date": "2026-06-01",
"value": 51.09141054797532
}
]
}
]
}
}WHOIS API
1 creditThe original port-43 WHOIS text, for TLDs that still serve it. For structured data use RDAP.
/ api/ v1/ domains/ {domain}/ whoisWHOIS is a legacy protocol. For modern, structured domain registration data, use the RDAP API instead.
Parameters
domainstringin pathRequiredRegistrable domain; reduced to the registrable root.
Example
vercel.com
Response
domainstringThe registrable domain.
whois_serverstring | nullThe port-43 WHOIS server that answered.
rawstringThe raw WHOIS response text, verbatim.
Errors: invalid_domain (400), insufficient_credits (402), unprocessable (422, no WHOIS server for this TLD), upstream_error (502). See error codes.
curl "https://tabapi.com/api/v1/domains/vercel.com/whois" \
-H "Authorization: Bearer sk_live_..."{
"domain": "vercel.com",
"whois_server": "whois.verisign-grs.com",
"raw": "Domain Name: VERCEL.COM\r\n Registry Domain ID: 10966907_DOMAIN_COM-VRSN\r\n Registrar WHOIS Server: whois.registrar.amazon\r\n Registrar URL: http://registrar.amazon.com\r\n Updated Date: 2026-05-16T15:54:35Z\r\n Creation Date: 1999-10-04T19:30:47Z\r\n Registry Expiry Date: 2029-10-04T19:30:47Z\r\n Registrar: Amazon Registrar, Inc.\r\n Registrar IANA ID: 468\r\n Registrar Abuse Contact Email: trustandsafety@support.aws.com\r\n Registrar Abuse Contact Phone: +1.2024422253\r\n Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\r\n Name Server: A.ZEIT-WORLD.CO.UK\r\n Name Server: B.ZEIT-WORLD.ORG\r\n Name Server: E.ZEIT-WORLD.COM\r\n Name Server: F.ZEIT-WORLD.NET\r\n DNSSEC: unsigned\r\n URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/\r\n>>> Last update of whois database: 2026-09-28T17:10:28Z <<<\r\n\r\nFor more information on Whois status codes, please visit https://icann.org/epp\r\n\r\nNOTICE: The expiration date displayed in this record is the date the\r\nregistrar's sponsorship of the domain name registration in the registry is\r\ncurrently set to expire. This date does not necessarily reflect the expiration\r\ndate of the domain name registrant's agreement with the sponsoring\r\nregistrar. Users may consult the sponsoring registrar's Whois database to\r\nview the registrar's reported date of expiration for this registration.\r\n\r\nTERMS OF USE: You are not authorized to access or query our Whois\r\ndatabase through the use of electronic processes that are high-volume and\r\nautomated except as reasonably necessary to register domain names or\r\nmodify existing registrations; the Data in VeriSign Global Registry\r\nServices' (\"VeriSign\") Whois database is provided by VeriSign for\r\ninformation purposes only, and to assist persons in obtaining information\r\nabout or related to a domain name registration record. VeriSign does not\r\nguarantee its accuracy. By submitting a Whois query, you agree to abide\r\nby the following terms of use: You agree that you may use this Data only\r\nfor lawful purposes and that under no circumstances will you use this Data\r\nto: (1) allow, enable, or otherwise support the transmission of mass\r\nunsolicited, commercial advertising or solicitations via e-mail, telephone,\r\nor facsimile; or (2) enable high volume, automated, electronic processes\r\nthat apply to VeriSign (or its computer systems). The compilation,\r\nrepackaging, dissemination or other use of this Data is expressly\r\nprohibited without the prior written consent of VeriSign. You agree not to\r\nuse electronic processes that are automated and high-volume to access or\r\nquery the Whois database except as reasonably necessary to register\r\ndomain names or modify existing registrations. VeriSign reserves the right\r\nto restrict your access to the Whois database in its sole discretion to ensure\r\noperational stability. VeriSign may restrict or terminate your access to the\r\nWhois database for failure to abide by these terms of use. VeriSign\r\nreserves the right to modify these terms at any time.\r\n\r\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\r\nRegistrars."
}RDAP API
1 creditStructured registration data (RFC 9083). RDAP-first; port-43-only records are converted to an RDAP-compatible object.
/ api/ v1/ domains/ {domain}/ rdapParameters
domainstringin pathRequiredRegistrable domain; reduced to the registrable root.
Example
vercel.com
Response
objectClassNamestring?Object class, normally "domain".
ldhNamestringDomain name in LDH (ASCII) form.
unicodeNamestring?Unicode / IDN form, when applicable.
statusstring[]?RDAP/EPP statuses (e.g. "client transfer prohibited").
eventsarray?Lifecycle events.
eventActionstring"registration", "last changed", "expiration", …
eventDatestringISO 8601 timestamp.
entitiesarray?Registrar and contacts (vCard data in vcardArray).
nameserversarray?Delegated nameservers ({ ldhName, … }).
secureDNSobject?DNSSEC delegation info ({ delegationSigned, … }).
port43string?Registrar WHOIS server, when advertised.
rawstring?Original WHOIS text, present only when resolved via the port-43 fallback.
Errors: invalid_domain (400), insufficient_credits (402), not_found (404, unregistered), unprocessable (422, unsupported TLD), upstream_error (502). See error codes.
curl "https://tabapi.com/api/v1/domains/vercel.com/rdap" \
-H "Authorization: Bearer sk_live_..."{
"objectClassName": "domain",
"handle": "10966907_DOMAIN_COM-VRSN",
"ldhName": "VERCEL.COM",
"status": [
"client transfer prohibited"
],
"entities": [
{
"objectClassName": "entity",
"handle": "468",
"roles": [
"registrar"
],
"publicIds": [
{
"type": "IANA Registrar ID",
"identifier": "468"
}
],
"vcardArray": [
"vcard",
[
[
"version",
{},
"text",
"4.0"
],
[
"fn",
{},
"text",
"Amazon Registrar, Inc."
]
]
]
}
],
"events": [
{
"eventAction": "registration",
"eventDate": "1999-10-04T19:30:47Z"
},
{
"eventAction": "expiration",
"eventDate": "2029-10-04T19:30:47Z"
},
{
"eventAction": "last changed",
"eventDate": "2026-05-16T15:54:35Z"
},
{
"eventAction": "last update of RDAP database",
"eventDate": "2026-09-28T17:06:43Z"
}
],
"secureDNS": {
"delegationSigned": false
},
"nameservers": [
{
"objectClassName": "nameserver",
"ldhName": "A.ZEIT-WORLD.CO.UK"
},
{
"objectClassName": "nameserver",
"ldhName": "B.ZEIT-WORLD.ORG"
},
{
"objectClassName": "nameserver",
"ldhName": "E.ZEIT-WORLD.COM"
},
{
"objectClassName": "nameserver",
"ldhName": "F.ZEIT-WORLD.NET"
}
],
"rdapConformance": [
"rdap_level_0",
"icann_rdap_technical_implementation_guide_1",
"icann_rdap_response_profile_1"
]
}DNS Lookup API
1 creditDNS records over DoH, with Cloudflare and Google queried in parallel.
/ api/ v1/ domains/ {domain}/ dnsParameters
domainstringin pathRequiredHostname to resolve (queried as-is, not reduced to the root).
Example
vercel.comtypeenumin queryDNS record type. Default NS.
allfans out over A, AAAA, MX, NS, TXT, CNAME.NSAAAAAMXTXTCNAMEall
Response
domainstringThe queried hostname.
statusstringDNS response code by name: NOERROR, NXDOMAIN, SERVFAIL, etc.
resolver"cloudflare" | "google"Selected DoH resolver. For type=all this identifies the A sub-query; other record types may come from the other resolver.
recordsarrayResource records.
typestringRecord type by name (e.g. "NS", "A", "MX").
namestringOwner name as returned by the resolver, commonly an FQDN ending in ".".
ttlnumberTime-to-live in seconds.
valuestringResolver-provided record data; DNS names may end in "." and TXT values may retain quotes.
Errors: invalid_domain (400), insufficient_credits (402), upstream_error (502). See error codes.
curl "https://tabapi.com/api/v1/domains/vercel.com/dns?type=all" \
-H "Authorization: Bearer sk_live_..."{
"domain": "vercel.com",
"status": "NOERROR",
"resolver": "google",
"records": [
{
"type": "A",
"name": "vercel.com.",
"ttl": 143,
"value": "64.239.123.65"
},
{
"type": "A",
"name": "vercel.com.",
"ttl": 143,
"value": "64.239.109.1"
},
{
"type": "MX",
"name": "vercel.com.",
"ttl": 872,
"value": "1 aspmx.l.google.com."
},
{
"type": "MX",
"name": "vercel.com.",
"ttl": 872,
"value": "10 aspmx3.googlemail.com."
},
{
"type": "NS",
"name": "vercel.com.",
"ttl": 21520,
"value": "ns1.vercel-dns.com."
},
{
"type": "NS",
"name": "vercel.com.",
"ttl": 21520,
"value": "ns2.vercel-dns.com."
},
{
"type": "TXT",
"name": "vercel.com.",
"ttl": 1800,
"value": "v=spf1 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com include:mktomail.com include:amazonses.com include:sendgrid.net include:_spf.salesforce.com include:spf.mtasv.net ~all"
}
]
}Backlinks API
5 creditsBacklink overview with domain rating, referring-domain counts, and a sample of top backlinks.
/ api/ v1/ domains/ {domain}/ backlinksParameters
domainstringin pathRequiredDomain or hostname, not a URL. The profile is scoped to that hostname and its subdomains.
Example
vercel.com
Response
domainstringThe queried domain.
overviewobjectAggregate backlink metrics.
domain_ratingnumberDomain Rating, 0-100.
backlinksnumberTotal backlinks.
referring_domainsnumberTotal referring domains.
dofollow_backlinks_pctnumberPercentage (0-100) of backlinks that are dofollow.
dofollow_referring_domains_pctnumberPercentage (0-100) of referring domains with a dofollow link.
backlinksarraySample of top backlinks.
from_urlstringReferring page URL.
to_urlstringTarget URL on the queried domain.
titlestringReferring page title.
anchorstringLink anchor text.
domain_ratingnumberDomain Rating of the referring domain.
Errors: invalid_domain (400), insufficient_credits (402), upstream_error (502), upstream_timeout (504). See error codes.
curl "https://tabapi.com/api/v1/domains/vercel.com/backlinks" \
-H "Authorization: Bearer sk_live_..."{
"domain": "vercel.com",
"overview": {
"domain_rating": 92,
"backlinks": 12452612,
"referring_domains": 108633,
"dofollow_backlinks_pct": 94,
"dofollow_referring_domains_pct": 91
},
"backlinks": [
{
"from_url": "https://openclaw.ai/",
"to_url": "https://vercel.com/",
"title": "OpenClaw — Open-Source AI Assistant",
"anchor": "Vercel Vercel",
"domain_rating": 88
},
{
"from_url": "https://nodejs.org/en",
"to_url": "https://vercel.com/",
"title": "Node.js — Run JavaScript Everywhere",
"anchor": "",
"domain_rating": 92
},
{
"from_url": "https://tailwindcss.com/",
"to_url": "https://vercel.com/",
"title": "Tailwind CSS - Rapidly build modern websites without ever leaving your HTML.",
"anchor": "",
"domain_rating": 90
}
]
}Domain Rating API
1 creditDomain rating: a 0-100 score for the strength of a domain’s backlink profile.
/ api/ v1/ domains/ {domain}/ domain-ratingParameters
domainstringin pathRequiredDomain or hostname, not a URL. Normalized to lowercase punycode and rated as given, not reduced to the registrable root.
Example
vercel.com
Response
domainstringThe rated hostname, normalized.
domain_ratingnumberDomain rating, 0-100. Higher means a stronger backlink profile; 0 means no measurable profile.
Errors: invalid_domain (400), insufficient_credits (402), upstream_error (502), upstream_timeout (504). See error codes.
curl "https://tabapi.com/api/v1/domains/vercel.com/domain-rating" \
-H "Authorization: Bearer sk_live_..."{
"domain": "vercel.com",
"domain_rating": 92
}URL endpoints
Pass a page address. We fetch it server-side, rendered or exactly as served.
Web Reader API
1 creditAny public URL as clean, LLM-ready Markdown with page metadata.
/ api/ v1/ markdownRequest body
urlstringA public HTTP/HTTPS URL. Private, local, and credential-bearing URLs are rejected.
Response
sourceobjectrequested_urlstringThe URL you asked for.
resolved_urlstringThe final URL after redirects.
http_statusnumberHTTP status of the fetched page.
pageobjectExtracted metadata: title, description, language, published_at, plus a sanitized metadata map.
outputobjectformatstring"markdown".
mime_typestring"text/markdown; charset=utf-8".
contentstringThe page content, converted to Markdown.
truncatedbooleantrue if content reached the service safety limit.
warningsstring[]Non-fatal notes about the conversion.
Errors: invalid_request (400), insufficient_credits (402), unprocessable (422), upstream_error (502), upstream_timeout (504). See error codes.
curl -X POST "https://tabapi.com/api/v1/markdown" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://vercel.com/"}'{
"source": {
"requested_url": "https://vercel.com/",
"resolved_url": "https://vercel.com/",
"http_status": 200
},
"page": {
"title": "Agentic Infrastructure - Vercel",
"description": "The autonomous stack for every app and agent.",
"language": "en",
"published_at": null,
"metadata": {
"og:site_name": "Vercel",
"og:type": "website",
"og:locale": "en_US"
}
},
"output": {
"format": "markdown",
"mime_type": "text/markdown; charset=utf-8",
"content": "[Skip to content](https://vercel.com/#geist-skip-nav)\n\nShip 26 is coming to SF\n\n[Get your ticket](https://vercel.com/ship?utm_campaign=ship-sf2026&utm_source=site&utm_medium=homepage)\n\n\n\nDrop to deployLoading\n\n## Build agents on infrastructure that thinks like them\n\n\n\n",
"truncated": false
},
"warnings": []
}Screenshot API
1 creditFirst-viewport PNG of any public URL, temporarily hosted on managed storage.
/ api/ v1/ screenshotRequest body
urlstringA public HTTP/HTTPS URL. Private, local, and credential-bearing URLs are rejected.
optionsobjectviewportobjectwidthnumber?Viewport width in px, 320–2560. Default 1920.
heightnumber?Viewport height in px, 240–2160. Default 1080.
Response
sourceobjectrequested_urlstringThe URL you asked for.
resolved_urlstringThe final URL after redirects.
http_statusnumberHTTP status of the captured page.
pageobjectExtracted metadata: title, description, language, published_at, plus a sanitized metadata map.
outputobjectformatstring"png".
mime_typestring"image/png".
urlstringTemporary files.tabapi.com image URL, guaranteed for at least 24 hours after this API response. Download it to your own storage for longer retention.
widthnumberImage width in pixels.
heightnumberImage height in pixels.
size_bytesnumberPNG size in bytes (max 5 MiB).
warningsstring[]Non-fatal notes about the capture.
Errors: invalid_request (400), insufficient_credits (402), unprocessable (422), internal_error (500, storage unavailable), upstream_error (502), upstream_timeout (504). See error codes.
curl -X POST "https://tabapi.com/api/v1/screenshot" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://news.ycombinator.com/","options":{"viewport":{"width":1920,"height":1080}}}'{
"source": {
"requested_url": "https://news.ycombinator.com/",
"resolved_url": "https://news.ycombinator.com/",
"http_status": 200
},
"page": {
"title": "Hacker News", "description": null,
"language": "en", "published_at": null, "metadata": {}
},
"output": {
"format": "png",
"mime_type": "image/png",
"url": "https://files.tabapi.com/screenshot/v1/550e8400-….png",
"width": 1920, "height": 1080, "size_bytes": 20531
},
"warnings": []
}HTML API
1 creditThe HTML a public URL serves, exactly as sent before any JavaScript runs, or the DOM after a browser ran it.
/ api/ v1/ htmlRequest body
urlstringA public HTTP/HTTPS URL. Private, local, and credential-bearing URLs are rejected.
renderbooleanOptional, default false. true returns the DOM after a real browser ran the page’s scripts, instead of the bytes the server sent. Slower: typically 5–15 seconds.
Response
sourceobjectrequested_urlstringThe URL you asked for.
resolved_urlstringThe final URL after redirects (up to 10 hops).
http_statusnumberHTTP status of the fetched page.
outputobjectformatstring"html".
mime_typestring"text/html; charset=utf-8".
renderedbooleantrue when content is the DOM after the page’s scripts ran (render: true).
encodingstringThe charset the page was served in (utf-8, gbk, shift_jis…); content is already decoded from it.
contentstringThe HTML document: as the server sent it, or the serialized DOM when rendered is true.
truncatedbooleantrue if the page exceeded 5 MiB and was cut.
warningsstring[]Non-fatal notes, such as a charset that could not be decoded.
Errors: invalid_request (400), insufficient_credits (402), unprocessable (422), upstream_error (502), upstream_timeout (504). See error codes.
curl -X POST "https://tabapi.com/api/v1/html" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://www.rust-lang.org/"}'{
"source": {
"requested_url": "https://www.rust-lang.org/",
"resolved_url": "https://rust-lang.org/",
"http_status": 200
},
"output": {
"format": "html",
"mime_type": "text/html; charset=utf-8",
"rendered": false,
"encoding": "utf-8",
"content": "<!doctype html>\n<html lang=\"en-US\">\n <head>\n <meta charset=\"utf-8\">\n <title>\n Rust Programming Language\n </title>\n <meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0\">\n <meta name=\"description\" content=\"A language empowering everyone to build reliable and efficient software.\">",
"truncated": false
},
"warnings": []
}SEO Audit API
2 creditsWhether search engines can crawl, index and show a page well: 23 checks, a 0–100 score and a fix list.
/ api/ v1/ audit/ seoRequest body
urlstringA public HTTP/HTTPS page. Private, local, and credential-bearing URLs are rejected.
Response
sourceobjectresolved_urlstringThe page the server ended on, after redirects; it is what was audited.
scorenumber0–100, the category scores weighted 25 / 30 / 20 / 10 / 15, after any cap.
gradeobjectletter (A–F) and label: A from 90, B from 75, C from 60, D from 40.
capobject | nullWhy the score was capped, if it was: max and reason; blocked is true when a failed blocker (a 404 or 410, a noindex rule) keeps the page out of search, which caps it at 39.
totalsobjectpassed, warnings and failed check counts; info and skipped checks are not counted.
categoriesobjectidstringindexing, appearance, content, links or mobile.
scorenumber | null0–100, or null when every check in the category was skipped.
checksobjectstatusstringpassed (1), warning (0.5), failed (0); info and skipped never count.
messagestringWhat the check found, and what to change.
sourcesobject[]label and url of the documents the rule rests on, the primary one first.
reportstringThe whole audit as Markdown, failures first, for an AI coding assistant.
warningsstring[]Notes, such as server HTML that could not be fetched (the checks that read it are then skipped).
Errors: invalid_request (400), insufficient_credits (402), unprocessable (422), upstream_error (502), upstream_timeout (504). See error codes.
curl -X POST "https://tabapi.com/api/v1/audit/seo" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://go.dev/"}'{
"source": {
"requested_url": "https://go.dev/",
"resolved_url": "https://go.dev/",
"http_status": 200
},
"score": 96,
"grade": {
"letter": "A",
"label": "Excellent — follows best practices"
},
"cap": null,
"totals": {
"passed": 18,
"warnings": 3,
"failed": 0
},
"categories": [
{
"id": "indexing",
"name": "Crawling & Indexing",
"weight": 25,
"score": 95,
"checks": [
{
"id": "http-status",
"title": "HTTP Status",
"weight": 2,
"sources": [
{
"label": "Google Search Essentials",
"url": "https://developers.google.com/search/docs/essentials/technical"
}
],
"status": "passed",
"message": "Returns 200 — the page works for crawlers."
},
{
"id": "robots-access",
"title": "Crawler Access",
"weight": 2,
"sources": [
{
"label": "Google: robots.txt",
"url": "https://developers.google.com/crawling/docs/robots-txt/robots-txt-spec"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "robots.txt lets Googlebot and Bingbot crawl this URL."
},
{
"id": "indexability",
"title": "Indexability",
"weight": 2,
"sources": [
{
"label": "Google: robots meta tag",
"url": "https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "No noindex or nofollow rule in the robots meta tags or the X-Robots-Tag header."
},
{
"id": "canonical",
"title": "Canonical URL",
"weight": 3,
"sources": [
{
"label": "Google: canonicalization",
"url": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "One absolute, self-referencing canonical."
},
{
"id": "robots-txt-valid",
"title": "robots.txt Validity",
"weight": 1,
"sources": [
{
"label": "Lighthouse: robots.txt",
"url": "https://developer.chrome.com/docs/lighthouse/seo/invalid-robots-txt/"
}
],
"status": "passed",
"message": "Every line of robots.txt is a directive crawlers understand."
},
{
"id": "sitemap",
"title": "XML Sitemap",
"weight": 1,
"sources": [
{
"label": "Google: sitemaps",
"url": "https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "warning",
"message": "No sitemap in robots.txt or at /sitemap.xml. Bing asks for one to discover URLs and keep them fresh; Google calls it optional for small, well-linked sites."
}
]
},
{
"id": "appearance",
"name": "Search Appearance",
"weight": 30,
"score": 100,
"checks": [
{
"id": "title",
"title": "Title",
"weight": 6,
"sources": [
{
"label": "Google: title links",
"url": "https://developers.google.com/search/docs/appearance/title-link"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "27 characters. Google sets no length limit; long titles are truncated to the result width."
},
{
"id": "meta-description",
"title": "Meta Description",
"weight": 3,
"sources": [
{
"label": "Google: snippets",
"url": "https://developers.google.com/search/docs/appearance/snippet"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "97 characters. Google sets no length limit; snippets are truncated as needed."
},
{
"id": "head-valid",
"title": "Metadata in <head>",
"weight": 2,
"sources": [
{
"label": "Google: valid page metadata",
"url": "https://developers.google.com/search/docs/crawling-indexing/valid-page-metadata"
}
],
"status": "passed",
"message": "Title, description, robots, canonical and hreflang all sit inside <head>."
},
{
"id": "structured-data",
"title": "Structured Data",
"weight": 1,
"sources": [
{
"label": "Google: structured data",
"url": "https://developers.google.com/search/docs/appearance/structured-data/sd-policies"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "info",
"message": "No structured data found. Optional: it makes a page eligible for rich results, never guaranteed."
},
{
"id": "snippet-controls",
"title": "Snippet Controls",
"weight": 1,
"sources": [
{
"label": "Google: robots meta tag",
"url": "https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "No rule stops search engines from showing a snippet."
}
]
}
],
"report": "# SEO Audit — go.dev\n\n_Generated by [TabAPI SEO Audit API](https://tabapi.com/seo-audit)._\n\n- URL: https://go.dev/\n- Score: 96/100 — Grade A (Excellent — follows best practices)\n- Checks: 18 passed · 3 warnings · 0 failed\n…",
"warnings": []
}GEO Audit API
2 creditsHow ready a page is to be cited by AI answer engines: 33 checks, a 0–100 score and a fix list.
/ api/ v1/ audit/ geoRequest body
urlstringA public HTTP/HTTPS page. Private, local, and credential-bearing URLs are rejected.
Response
sourceobjectresolved_urlstringThe page the server ended on, after redirects; it is what was audited.
scorenumber0–100, the category scores weighted 25 / 20 / 15 / 30 / 10, after any cap.
gradeobjectletter (A–F) and label: A from 90, B from 75, C from 60, D from 40.
capobject | nullWhy the score was capped, if it was: max and reason; blocked is true when a failed blocker (such as noindex) makes the page ineligible, which caps it at 39.
totalsobjectpassed, warnings and failed check counts; info and skipped checks are not counted.
categoriesobjectidstringcrawlers, readability, structured, citability or trust.
scorenumber | null0–100, or null when every check in the category was skipped.
checksobjectstatusstringpassed (1), warning (0.5), failed (0); info and skipped never count.
messagestringWhat the check found, and what to change.
sourcesobject[]label and url of the documents the rule rests on, the primary one first.
reportstringThe whole audit as Markdown, failures first, for an AI coding assistant.
warningsstring[]Notes, such as server HTML that could not be fetched (the checks that read it are then skipped).
Errors: invalid_request (400), insufficient_credits (402), unprocessable (422), upstream_error (502), upstream_timeout (504). See error codes.
curl -X POST "https://tabapi.com/api/v1/audit/geo" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://go.dev/"}'{
"source": {
"requested_url": "https://go.dev/",
"resolved_url": "https://go.dev/",
"http_status": 200
},
"score": 90,
"grade": {
"letter": "A",
"label": "Excellent — AI-ready"
},
"cap": null,
"totals": {
"passed": 20,
"warnings": 3,
"failed": 0
},
"categories": [
{
"id": "crawlers",
"name": "AI Crawler Access",
"weight": 25,
"score": 100,
"checks": [
{
"id": "ai-search-crawlers",
"title": "AI Search Crawlers",
"weight": 3,
"sources": [
{
"label": "Google: AI features",
"url": "https://developers.google.com/search/docs/appearance/ai-features"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
},
{
"label": "OpenAI: crawlers",
"url": "https://developers.openai.com/api/docs/bots"
},
{
"label": "Anthropic: crawlers",
"url": "https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler"
},
{
"label": "Perplexity: crawlers",
"url": "https://docs.perplexity.ai/guides/bots"
}
],
"status": "passed",
"message": "All citation-critical crawlers (OpenAI, Anthropic, Perplexity, Google, Bing) may access this page."
},
{
"id": "ai-user-crawlers",
"title": "AI Assistant Fetchers",
"weight": 2,
"sources": [
{
"label": "OpenAI: crawlers",
"url": "https://developers.openai.com/api/docs/bots"
},
{
"label": "Anthropic: crawlers",
"url": "https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler"
},
{
"label": "Perplexity: crawlers",
"url": "https://docs.perplexity.ai/guides/bots"
}
],
"status": "passed",
"message": "User-triggered fetchers (ChatGPT-User, Claude-User, Perplexity-User) get your real content."
},
{
"id": "indexability",
"title": "Indexability",
"weight": 3,
"sources": [
{
"label": "Google: AI features",
"url": "https://developers.google.com/search/docs/appearance/ai-features"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "No noindex rule — the prerequisite for appearing in AI Overviews, Copilot and AI answers."
},
{
"id": "snippet-controls",
"title": "Snippet Controls",
"weight": 2,
"sources": [
{
"label": "Google: AI features",
"url": "https://developers.google.com/search/docs/appearance/ai-features"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "passed",
"message": "No snippet restrictions — AI engines may quote the page content in answers."
},
{
"id": "ai-training-crawlers",
"title": "AI Training Crawlers",
"weight": 0,
"sources": [
{
"label": "OpenAI: crawlers",
"url": "https://developers.openai.com/api/docs/bots"
},
{
"label": "Anthropic: crawlers",
"url": "https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler"
}
],
"status": "info",
"message": "Training crawlers (GPTBot, Google-Extended, CCBot, …) are allowed — content may inform future AI model knowledge."
}
]
},
{
"id": "structured",
"name": "Structured Data",
"weight": 15,
"score": 50,
"checks": [
{
"id": "jsonld-present",
"title": "Schema Markup",
"weight": 3,
"sources": [
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
},
{
"label": "Microsoft: content for AI answers",
"url": "https://about.ads.microsoft.com/en/blog/post/october-2025/optimizing-your-content-for-inclusion-in-ai-search-answers"
},
{
"label": "Google: AI features",
"url": "https://developers.google.com/search/docs/appearance/ai-features"
}
],
"status": "warning",
"message": "No structured data. Not required by Google AI features, but Microsoft recommends schema to label content."
},
{
"id": "entity-schema",
"title": "Entity Schema",
"weight": 2,
"sources": [
{
"label": "Google: Organization markup",
"url": "https://developers.google.com/search/docs/appearance/structured-data/organization"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "skipped",
"message": "No JSON-LD to read (see Schema Markup)."
},
{
"id": "content-schema",
"title": "Content Schema",
"weight": 2,
"sources": [
{
"label": "Microsoft: content for AI answers",
"url": "https://about.ads.microsoft.com/en/blog/post/october-2025/optimizing-your-content-for-inclusion-in-ai-search-answers"
},
{
"label": "Bing Webmaster Guidelines",
"url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a"
}
],
"status": "skipped",
"message": "No JSON-LD to read (see Schema Markup)."
},
{
"id": "same-as",
"title": "sameAs Entity Links",
"weight": 2,
"sources": [
{
"label": "Google: Organization markup",
"url": "https://developers.google.com/search/docs/appearance/structured-data/organization"
}
],
"status": "skipped",
"message": "No JSON-LD to read (see Schema Markup)."
}
]
}
],
"report": "# GEO Audit — go.dev\n\n_Generated by [TabAPI GEO Audit API](https://tabapi.com/geo-audit)._\n\n- URL: https://go.dev/\n- Score: 90/100 — Grade A (Excellent — AI-ready)\n- Checks: 20 passed · 3 warnings · 0 failed\n…",
"warnings": []
}Keyword Density API
1 creditThe words and 2–5 word phrases a page repeats most, with counts and density.
/ api/ v1/ keyword-densityRequest body
urlstringA public HTTP/HTTPS page. Private, local, and credential-bearing URLs are rejected.
limitintegerKeywords returned per phrase size, 1–1000; default 50. distinct still counts them all.
Response
sourceobjectresolved_urlstringThe page the fetch ended on, after redirects; it is what was counted.
total_wordsnumberWords in the server HTML’s text, stop words and numbers included: the denominator of every density.
phrase_sizesobjectsizenumberWords per phrase, 1 to 5; always five entries, in that order.
distinctnumberDistinct phrases of this size on the page, however many are returned.
keywordsobjectkeywordstringLowercased. No stop word or number is a keyword, and a phrase neither starts nor ends with one (rent a car).
countnumberTimes it occurs; the list is ordered by it, ties by first appearance.
densitynumbercount / total_words, as a fraction: 0.0226 is 2.26%.
found_instring[]Where else it appears: title, description (meta) and h1, in that order; empty when in none.
warningsstring[]Notes, such as server HTML with no words (text a script adds is not counted), or a page too long to read whole.
Errors: invalid_request (400), insufficient_credits (402), unprocessable (422), upstream_error (502), upstream_timeout (504). See error codes.
curl -X POST "https://tabapi.com/api/v1/keyword-density" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://vercel.com/blog/the-rise-of-the-ai-crawler","limit":10}'{
"source": {
"requested_url": "https://vercel.com/blog/the-rise-of-the-ai-crawler",
"resolved_url": "https://vercel.com/blog/the-rise-of-the-ai-crawler",
"http_status": 200
},
"total_words": 1768,
"phrase_sizes": [
{
"size": 1,
"distinct": 566,
"keywords": [
{
"keyword": "ai",
"count": 40,
"density": 0.02262443438914027,
"found_in": [
"title",
"description",
"h1"
]
},
{
"keyword": "content",
"count": 26,
"density": 0.014705882352941176,
"found_in": [
"description"
]
},
{
"keyword": "crawlers",
"count": 24,
"density": 0.013574660633484163,
"found_in": [
"description"
]
},
{
"keyword": "web",
"count": 19,
"density": 0.010746606334841629,
"found_in": [
"description"
]
},
{
"keyword": "javascript",
"count": 16,
"density": 0.00904977375565611,
"found_in": [
"description"
]
},
{
"keyword": "copy",
"count": 15,
"density": 0.008484162895927601,
"found_in": []
},
{
"keyword": "data",
"count": 15,
"density": 0.008484162895927601,
"found_in": []
},
{
"keyword": "fetches",
"count": 14,
"density": 0.007918552036199095,
"found_in": []
},
{
"keyword": "vercel",
"count": 13,
"density": 0.007352941176470588,
"found_in": [
"title"
]
},
{
"keyword": "claude",
"count": 13,
"density": 0.007352941176470588,
"found_in": [
"description"
]
}
]
},
{
"size": 2,
"distinct": 395,
"keywords": [
{
"keyword": "ai crawlers",
"count": 17,
"density": 0.009615384615384616,
"found_in": [
"description"
]
},
{
"keyword": "copy link",
"count": 12,
"density": 0.006787330316742082,
"found_in": []
},
{
"keyword": "javascript rendering",
"count": 4,
"density": 0.0022624434389140274,
"found_in": [
"description"
]
},
{
"keyword": "web applications",
"count": 4,
"density": 0.0022624434389140274,
"found_in": []
},
{
"keyword": "million fetches",
"count": 4,
"density": 0.0022624434389140274,
"found_in": []
},
{
"keyword": "traditional search",
"count": 4,
"density": 0.0022624434389140274,
"found_in": []
},
{
"keyword": "search engines",
"count": 4,
"density": 0.0022624434389140274,
"found_in": []
},
{
"keyword": "rendering capabilities",
"count": 4,
"density": 0.0022624434389140274,
"found_in": []
},
{
"keyword": "agent stack",
"count": 3,
"density": 0.0016968325791855204,
"found_in": []
},
{
"keyword": "ai sdk",
"count": 3,
"density": 0.0016968325791855204,
"found_in": []
}
]
},
{
"size": 3,
"distinct": 326,
"keywords": [
{
"keyword": "link to heading",
"count": 12,
"density": 0.006787330316742082,
"found_in": []
},
{
"keyword": "traditional search engines",
"count": 4,
"density": 0.0022624434389140274,
"found_in": []
},
{
"keyword": "alice alexandra moore",
"count": 3,
"density": 0.0016968325791855204,
"found_in": []
},
{
"keyword": "chatgpt and claude",
"count": 3,
"density": 0.0016968325791855204,
"found_in": []
},
{
"keyword": "high 404 rates",
"count": 3,
"density": 0.0016968325791855204,
"found_in": []
},
{
"keyword": "log in sign",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "requests across vercel's",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "modern web applications",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "validate our findings",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "gemini and search",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
}
]
},
{
"size": 4,
"distinct": 287,
"keywords": [
{
"keyword": "copy link to heading",
"count": 12,
"density": 0.006787330316742082,
"found_in": []
},
{
"keyword": "presence on the web",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "requests across vercel's network",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "show less predictable patterns",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "heading for site owners",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "claude don't execute javascript",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "demo log in sign",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
},
{
"keyword": "rise of the ai",
"count": 1,
"density": 0.0005656108597285068,
"found_in": [
"title",
"h1"
]
},
{
"keyword": "real-world data from merj",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
},
{
"keyword": "merj and vercel shows",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
}
]
},
{
"size": 5,
"distinct": 259,
"keywords": [
{
"keyword": "significant presence on the web",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "link to heading for site",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "chatgpt and claude don't execute",
"count": 2,
"density": 0.0011312217194570137,
"found_in": []
},
{
"keyword": "rise of the ai crawler",
"count": 1,
"density": 0.0005656108597285068,
"found_in": [
"title",
"h1"
]
},
{
"keyword": "data from merj and vercel",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
},
{
"keyword": "merj and vercel shows distinct",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
},
{
"keyword": "shows distinct patterns from top",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
},
{
"keyword": "distinct patterns from top ai",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
},
{
"keyword": "patterns from top ai crawlers",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
},
{
"keyword": "crawlers have become a significant",
"count": 1,
"density": 0.0005656108597285068,
"found_in": []
}
]
}
],
"warnings": []
}Query & ID endpoints
Pass a query, an identifier, or a list of targets.
Google Search API
1 creditLive Google results as structured JSON: organic and paid results, answer box, knowledge graph, People Also Ask, related searches.
/ api/ v1/ search/ googleParameters
qstringin queryRequiredSearch query, 1–500 characters. Operators such as site: and inurl: are preserved.
Default
png to svgcountrystringin queryTwo-letter country code used to localize results. Default us.
Default
uslanguagestringin queryLanguage code used to localize results, e.g. en or zh-cn. Default en.
Default
enpageintegerin queryOne-based results page, 1–10. Every page holds 10 results.
Default
1
Response
search_parametersobjectEcho of the executed query: query, country, language, page, results_per_page.
organic_resultsarrayRanked organic results.
positionnumber1-based rank on this page.
titlestringResult title.
linkstringTarget URL.
snippetstring | nullResult snippet text.
datestring | nullDate label Google shows, when present.
sitelinksarraySitelinks ({ title, link }).
paid_resultsarrayAds with position, placement (top | bottom), title, link, snippet.
answer_boxobject | nullFeatured snippet / direct answer: { type, title, answer, snippet, link }.
knowledge_graphobject | nullEntity panel: title, type, website, description, attributes.
people_also_askarrayPAA questions with answer text and source link.
related_searchesarrayRelated queries ({ position, query, link }).
Errors: invalid_request (400), insufficient_credits (402), upstream_error (502), upstream_timeout (504). See error codes.
curl "https://tabapi.com/api/v1/search/google?q=png+to+svg&country=us" \
-H "Authorization: Bearer sk_live_..."{
"search_parameters": { "query": "png to svg", "country": "us", "language": "en", "page": 1, "results_per_page": 10 },
"organic_results": [
{
"position": 1, "title": "PNG to SVG Converter — Free Online Image Vectorizer ...", "link": "https://pngtosvg.com/",
"displayed_link": "pngtosvg.com", "snippet": "Turn PNG, JPG and WEBP images into crisp, infinitely scalable SVG vectors. …",
"date": null, "sitelinks": [], "attributes": {}
},
…
],
"paid_results": [],
"answer_box": null,
"knowledge_graph": null,
"people_also_ask": [],
"related_searches": [ { "position": 1, "query": "PNG to SVG with color", "link": null }, … ]
}Reverse AdSense API
3 creditsDomains observed displaying a given Google AdSense publisher id.
/ api/ v1/ publishers/ {pub_id}/ sitesParameters
pub_idstringin pathRequiredA 16-digit AdSense publisher id, with or without the
pub-prefix; normalized topub-….Example
pub-1313834454494130
Response
publisher_idstringNormalized publisher id ("pub-…").
total_sitesnumberTotal number of homepage matches reported for this publisher id.
sitesstring[]Returned sample of domains observed displaying this publisher id on their homepage.
Errors: invalid_request (400, bad pub_id), unauthorized/invalid_api_key (401), insufficient_credits (402), internal_error (500), upstream_error (502), upstream_timeout (504). See error codes.
curl "https://tabapi.com/api/v1/publishers/pub-1313834454494130/sites" \
-H "Authorization: Bearer sk_live_..."{
"publisher_id": "pub-1313834454494130",
"total_sites": 7,
"sites": [
"top5onlinegames.co.uk",
"top5jeuxenligne.fr",
"topbrowsergames.de",
"top5jogosonline-br.com",
"meilleurs-jeux-par-navigateur.fr",
"top5onlinegames-kr.com",
"top-browsergames.com"
]
}Errors
Every error is JSON in one shape. Branch on code, which is stable, not on message, which may change. Each error links its row below through docs_url, and errors are never charged.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | Malformed request (bad JSON, missing/invalid parameter). |
| 400 | invalid_domain | Domain failed validation/normalization (includes IPs). |
| 401 | unauthorized | Missing/malformed credentials (or a key in the query string). |
| 401 | invalid_api_key | Key unknown, revoked, or deleted. |
| 402 | insufficient_credits | Balance below the endpoint cost. Nothing is charged. |
| 404 | not_found | Unknown route. |
| 405 | method_not_allowed | Wrong HTTP method for this route. |
| 422 | unprocessable | Valid domain the service cannot fulfil (e.g. a TLD with no WHOIS/RDAP). |
| 500 | internal_error | Unexpected server error. |
| 502 | upstream_error | An upstream data source failed. |
| 503 | service_unavailable | Temporary service contention. Retry after Retry-After seconds. |
| 504 | upstream_timeout | An upstream data source timed out. |
{
"error": {
"code": "insufficient_credits",
"message": "...",
"status": 402,
"request_id": "req_...",
"docs_url": "https://tabapi.com/docs#error-insufficient_credits"
}
}OpenAPI & AI
No SDK required: every endpoint is plain HTTPS with a bearer header. For generated clients and AI tools, the contract also ships in machine form.
Generate a typed client
The contract is published as OpenAPI 3.1 at /api/v1/openapi.json. Point Postman, Swagger UI or a generator at it.
Hand the docs to your AI
This page mirrors to Markdown at /docs.txt, and the site indexes itself at /llms.txt and /llms-full.txt.
Spec URLhttps://tabapi.com/api/v1/openapi.json
npx openapi-typescript https://tabapi.com/api/v1/openapi.json -o tabapi.d.ts