Ranking API
Ranking API — live search positions as data
Turn search rankings into structured data your application can use. One endpoint returns ordered results with exact positions for any keyword and market, at $0.30 per 1,000 queries.
{ "searchTime": 0.17, "totalResults": 85000, "page": 1, "organic": [ { "position": 1, "title": "31.10. Connection Pools and Data Sources", "link": "www.postgresql.org/docs/…", "domain": "postgresql.org", "snippet": "For an environment without an application se…" }, { "position": 2, "domain": "medium.com", … }, { "position": 3, "domain": "stackoverflow.blog", … } ], "credits": 1}A ranking API exposes the order of search results as machine-readable data. Instead of looking at a results page, your code receives an array where each entry carries its rank, domain, title, and link — ready to index, store, and analyze.
Searlo's ranking API covers live Google results with full SERP features, across 195 markets, at a flat $0.30 per 1,000 queries. It is the building block under rank trackers, visibility scores, and competitive-intelligence tools.
Features
Ordered, positioned results
Each result includes its exact rank so ordering and position logic are trivial.
Any market
Country and language parameters return rankings as they appear locally.
Composable data
Clean JSON or TOON output drops straight into pipelines and data stores.
Fast and predictable
Sub-second responses and flat per-query pricing.
Get started in one request
The ranking API returns ordered results; each item's position is its rank.
curl "https://api.searlo.tech/api/v1/search/web?q=cloud%20storage%20providers&num=10" \
-H "x-api-key: YOUR_API_KEY"import requests
r = requests.get(
"https://api.searlo.tech/api/v1/search/web",
params={"q": "cloud storage providers", "num": 10},
headers={"x-api-key": "YOUR_API_KEY"},
)
results = r.json()["organic"]
for o in results:
print(o["position"], o["domain"], o["title"])const res = await fetch(
"https://api.searlo.tech/api/v1/search/web?q=" +
encodeURIComponent("cloud storage providers") + "&num=10",
{ headers: { "x-api-key": "YOUR_API_KEY" } },
);
const { organic } = await res.json();
organic.forEach(o =>
console.log(o.position, o.domain, o.title));Searlo vs DataForSEO
DataForSEO is a large data marketplace. Searlo offers a simpler, faster ranking endpoint with transparent per-query pricing.
| Capability | Searlo | DataForSEO |
|---|---|---|
| Setup | One GET request | Task-queue model |
| Latency | Sub-second, synchronous | Often async/polled |
| Price | $0.30 / 1,000 queries | Tiered, per-endpoint |
| AI/TOON output | Yes | No |
| Free credits | 3,000 | Limited trial |
What you do with ranking data
Once rankings are data, the use cases open up: store positions over time to chart movement, compare domains to compute share of voice, or join ranking data with your own analytics to connect positions to traffic and revenue.
Because every result is returned — not just the top one — you get the full competitive ordering for each query in a single call.
- Rank tracking and history
- Visibility and share-of-voice scoring
- Competitive ordering per keyword
- Joining rankings with analytics data
Built on the ranking API
- Rank trackers and position monitors
- Visibility and SOV dashboards
- Competitive intelligence tools
- SEO reporting automation
- Market-by-market ranking analysis
- AI agents that read live rankings
FAQ
Frequently asked questions
What is a ranking API?
An API that returns search results as ordered, positioned data, so applications can read and store exact ranks instead of parsing a results page.
Does it return all results or just the top one?
All organic results on the page are returned with their positions, giving you the full competitive ordering for each query.
Can I get rankings for specific countries?
Yes. Country and language parameters return rankings exactly as they appear in that market.
How is it priced?
Flat $0.30 per 1,000 queries with no per-endpoint surcharges, plus 3,000 free credits.
Is the API synchronous?
Yes. A single GET request returns the ranked results directly — no task queue or polling.