Docs menu

Crawlora Docs

Build a SERP Monitoring Workflow

Build a SERP monitoring API workflow for rank tracking, competitor visibility, result URL history, and search-result change alerts.

Try first API Copy examples Plan credits

Overview

Build a SERP monitoring API workflow for rank tracking, competitor visibility, result URL history, and search-result change alerts.

What you will build

Define keyword list
Select country and language
Track target and competitor domains
Schedule requests
Store organic results
Compare rank changes
Alert on movement

APIs used

Only endpoints that exist in the generated endpoint metadata are linked here. Missing optional endpoints are intentionally omitted.

POSTGoogleapiKey3 credits/request

Google search API

/google/search

Returns normalized Google web search results. Results are fetched through proxied browser renderers that race several concurrent renders per request and return the first clean result, with stale-cache fallback when available. The endpoint returns 503 when Google serves a challenge page or unusable HTML. Rate limit is enforced at 1 request per second, and if the limit is exceeded a 429 status code is returned with rate limit headers.

View docs Try in Playground

GETBingapiKey3 credits/request

Search Bing web results

/bing/search

Returns normalized Bing web search results for a query string, including organic results, optional context panel data, related queries, people-also-ask questions, news modules, video modules, and page-based pagination. Empty optional blocks are omitted from the JSON response. Locale defaults to country=us and lang=en-us. Results are fetched with the repo's Chrome-impersonated request client and return 503 when Bing serves a challenge page or unusable HTML.

View docs Try in Playground

GETBraveapiKey3 credits/request

Search Brave

/brave/search

Returns normalized web search results from Brave Search for a query string, along with offset-based pagination, related queries, discussions, videos, and the right-side knowledge card when Brave includes one. Use time_range for preset ranges or date_from/date_to for a custom YYYY-MM-DD range. Locale defaults to country=us and lang=en-us.

View docs Try in Playground

POSTGoogle TrendsapiKey3 credits/request

Google Trends trending term detail

/google/trends/trending/detail

Returns the Explore detail widgets for a single trending term, including interest over time, regional interest, top/rising related queries, and related topics when Google returns them.

View docs Try in Playground

Data model

Field	Notes
keyword	Workflow field; map to exact endpoint response fields from endpoint docs.
country	Workflow field; map to exact endpoint response fields from endpoint docs.
language	Workflow field; map to exact endpoint response fields from endpoint docs.
result_url	Workflow field; map to exact endpoint response fields from endpoint docs.
title	Workflow field; map to exact endpoint response fields from endpoint docs.
snippet	Workflow field; map to exact endpoint response fields from endpoint docs.
rank	Workflow field; map to exact endpoint response fields from endpoint docs.
checked_at	Workflow field; map to exact endpoint response fields from endpoint docs.
request_id	Workflow field; map to exact endpoint response fields from endpoint docs.
credits_used	Include when response or usage data makes it available.

Step-by-step workflow

1.Define keyword list
2.Select country and language
3.Track target and competitor domains
4.Schedule requests
5.Store organic results
6.Compare rank changes
7.Alert on movement

Example request

This example uses the real Google search API endpoint. Exact request fields come from the endpoint metadata.

Recipe request

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X POST "https://api.crawlora.net/api/v1/google/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us","keyword":"chatgpt","language":"en","limit":10,"page":1}'

Example response

Use endpoint detail pages for exact response schemas. This recipe does not invent response fields.

Generated example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "result": [
      {
        "position": 1,
        "title": "ChatGPT",
        "website_name": "ChatGPT",
        "icon": "",
        "link": "https://chatgpt.com/",
        "Snippet": "ChatGPT helps you get answers and create."
      }
    ]
  }
}

Storage/output suggestion

Store one row per keyword, engine, result, and check in a relational table or analytics warehouse so rank changes can be compared over time.

Error handling

Validate required inputs before calling Crawlora
Retry 429 and temporary 5xx responses with capped backoff
Log endpoint, input, timestamp, and request ID when present
Treat empty results as a state your application can handle
Open /docs/errors for production retry guidance

Rate-limit and credit planning

Estimate usage by multiplying requests by endpoint credit cost. The table below only shows real credit costs available from the billing constants.

Endpoint	Credit cost	Docs
Google search API	3 credits/request	/docs/google/google-search
Search Bing web results	3 credits/request	/docs/bing/bing-search
Search Brave	3 credits/request	/docs/brave/brave-search
Google Trends trending term detail	3 credits/request	/docs/google-trends/google-trends-trending-detail

Production checklist

Keep API keys server-side
Use request timeouts
Back off on rate limits
Store raw responses or source IDs for auditability
Monitor credits and failures
Avoid unnecessary refreshes
Review responsible-use requirements

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

Related APIs and pages

Google search API Search Bing web results Search Brave Google Trends trending term detail /use-cases/serp-monitoring /use-cases/serp-tracker-api /use-cases/serp-tracking-api /use-cases/white-label-serp-tracking-api /use-cases/serp-rank-checker-api /platforms/google-search /platforms/bing /platforms/brave /platforms/google-trends

Build this workflow with real endpoint docs

Use this recipe for workflow shape, then rely on endpoint reference pages for exact paths, request schemas, response schemas, and credit costs.

Browse APIs Try Playground