API Description

SERP Results

IMPORTANT: This is the Data API (api.seranking.com). For Project API (api4.seranking.com, included in Business/Enterprise plans), see Project API Docs. API keys are not interchangeable—use the correct one to avoid authentication errors.

If you’re seeing auth errors or need help, contact [email protected] for support.

The SERP Results API allows retrieving TOP 100 search engine results pages (SERPs) for keywords, including URLs, titles, and snippets, without needing a project in SE Ranking. Endpoints support task queuing, status checks, and listing recent tasks. Using the ‘Add SERP Tasks’ endpoint costs: 10 credits per request.

Add SERP Tasks

This method allows users to add one or more search queries to the queue for obtaining SERP results. It’s designed for retrieving the TOP 100 SERP results for key phrases (with URL, snippet, site position) without having an active project in SE Ranking.

Request Parameters: serp/tasks

ParameterLocationData TypeMandatoryDefault ValueDescriptionExample
engine_idbodyintegerYesN/AUnique search-engine identifier. See Search Engines list by Country.1830
query[]bodyarray of stringsYesN/AArray of keywords; each ≤ 255 characters; max 1,000 keywords per request.[“avocado”, “interstellar”]

POST Request

The request should be made as a POST request with parameters sent as form data.

Title of the code block
Copy
curl -X POST 'https://api.seranking.com/v1/serp/tasks' \
-H 'Authorization: Token YOUR_API_KEY' \
--data '{
"engine_id": 1830,
"query": [
"avocado",
"interstellar"
]
}'

Response Parameters: serp/tasks

If successful, the server returns a JSON array. Each object in this array corresponds to one of the queries submitted in the request and contains the unique task ID.

ParameterData TypeDescriptionExample
querystringThe keyword phrase submitted in the request.“avocado”
task_idintegerThe unique ID assigned to the SERP collection task for this query.241516328

Sample Request: serp/tasks

Title of the code block
Copy
curl -X POST 'https://api.seranking.com/v1/serp/tasks' \
-H 'Authorization: Token YOUR_API_KEY' \
--data '{
"engine_id": 1830,
"query": [
"avocado",
"interstellar"
]
}'

Sample Response: serp/tasks

Title of the code block
Copy
[
{
"query": "moto",
"task_id": 241516328
},
{
"query": "car",
"task_id": 241516331
}
]

Get SERP Task Status and Results

This method allows retrieving the status or results of a SERP task previously added to the Add SERP Tasks endpoint. If the SERP results have not yet been collected, the method returns the status. The results are stored for 24 hours, after which they are deleted.

Request Parameters: serp/tasks/status

ParameterLocationData TypeMandatoryDefault ValueDescriptionExample
task_idquerystringYesN/AThe unique ID of the query task, obtained from the “Create SERP Task” method.241516337

GET Request

The request should be made as a GET request with the task_id parameter included as a query parameter in the endpoint URL.

Title of the code block
Copy
curl -X GET 'https://api.seranking.com/v1/serp/tasks/status?task_id=241516337' \
-H 'Authorization: Token YOUR_API_KEY'

Response Parameters: serp/tasks/status

The response structure depends on the task’s status.

  • If the task is still in progress, the server returns an object with a status field.
ParameterData TypeDescriptionExample
statusstringIndicates that the task is currently being processed.“processing”
  • If the task is complete, the server returns an object containing a results array with the TOP 100 SERP data.
ParameterData TypeDescriptionExample
resultsarrayAn array of objects, where each object represents a single search result.
results[].positionstringThe ranking position in the TOP 100 SERP.“1”
results[].urlstringThe URL of the ranked page.“https://motorola.com/”
results[].titlestringThe title of the ranked page as it appears in the SERP.“Motorola”
results[].snippetstringThe description snippet for the page shown in the SERP.“Motorolahttps://motorola.comMotorola”
results[].cache_urlstringA link to the cached copy of the page, if available.“”

Sample Request: serp/tasks/status

Title of the code block
Copy
curl -X GET 'https://api.seranking.com/v1/serp/tasks/status?task_id=18639398' \
-H 'Authorization: Token YOUR_API_KEY'

Sample Response: serp/tasks/status

  • Sample Response (Processing)
Title of the code block
Copy
{
"status": "processing"
}
  • Sample Response (Completed)
Title of the code block
Copy
{
"results": [
{
"position": 1,
"url": "https://www.pizzahut.com/",
"title": "Pizza Hut: Pizza Delivery",
"snippet": "Order pizza online for fast delivery or carryout from a store near you. View our full menu, see nutritional information, find store locations, and more.",
"cache_url": "https://webcache.googleusercontent.com/search?q=cache:oiTvlHsuOeEJ:https://www.pizzahut.com/+&cd=4&hl=en&ct=clnk&gl=us"
},
{
"position": 2,
"url": "https://www.dominos.com/",
"title": "Domino's Pizza: Pizza Delivery & Carryout",
"snippet": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders.",
"cache_url": "..."
},
...
]
}

List SERP Tasks

This method allows obtaining a list of all user SERP queries that were added to the queue in the last 24 hours.

GET Request

The request should be made as a GET request with no additional parameters.

Title of the code block
Copy
curl -X GET 'https://api.seranking.com/v1/serp/tasks' \
-H 'Authorization: Token YOUR_API_KEY'

Response Parameters: serp/tasks

If successful, the server returns an object containing a tasks array. Each object in the array represents a single task.

ParameterData TypeDescriptionExample
tasksarray of objectsAn array of task objects.
tasks[].idstringThe unique ID of the query task.“241516340”
tasks[].account_idstringThe unique ID of the user’s account.“4242308”
tasks[].querystringThe keyword for the task.“moto”
tasks[].region_namestringThe region specified for the search. Can be null.null
tasks[].engine_idstringThe unique ID of the search engine used.“1830”
tasks[].addedstringThe timestamp (UTC) when the task was added to the queue.“2025-07-14 08:39:18”
tasks[].is_completedstringThe completion status of the task. 1 if completed, 0 otherwise.“1”
tasks[].need_detailed_resultsstringAn internal flag indicating if detailed results were requested.“0”
tasks[].uulestringThe UULE code for the specified location, if applicable. Can be null.null

Sample Request: serp/tasks

Title of the code block
Copy
curl -X GET 'https://api.seranking.com/v1/serp/tasks' \
-H 'Authorization: Token YOUR_API_KEY'

Sample Response: serp/tasks

Title of the code block
Copy
[
{
"id": "241516328",
"account_id": "4242308",
"query": "moto",
"region_name": null,
"engine_id": "1830",
"added": "2025-07-14 08:39:18",
"is_completed": "1",
"need_detailed_results": "0",
"uule": null
},
{
"id": "241516340",
"account_id": "4242308",
"query": "buy cordless electric drills Austin USA",
"region_name": "United States",
"engine_id": "200",
"added": "2025-07-14 08:48:45",
"is_completed": "1",
"need_detailed_results": "0",
"uule": null
}
]

Supported Engine IDs by Country

The following table lists available Search Engine, countries, and corresponding engine IDs for desktop and mobile searches.

Search Enginecountryengine_id – desktopengine_id – mobile
GoogleAfghanistan2031543
GoogleAlgeria2471587
GoogleAmerican Samoa2091549
GoogleAndorra2011541
GoogleAngola2071547
GoogleAnguilla2051545
GoogleAntigua and Barbuda2041544
GoogleArgentina2081548
GoogleArmenia2061546
GoogleAustralia2111551
GoogleAustria2101550
GoogleAzerbaijan2121552
GoogleBahamas2241564
GoogleBahrain2181558
GoogleBangladesh2141554
GoogleBelarus2261566
GoogleBelgium2151555
GoogleBelize2271567
GoogleBenin2201560
GoogleBolivia2221562
GoogleBosnia and Herzegovina2131553
GoogleBotswana2251565
GoogleBrazil2231563
GoogleBritish Virgin Islands3731713
GoogleBrunei2211561
GoogleBulgaria2171557
GoogleBurkina Faso2161556
GoogleBurundi2191559
GoogleCambodia2851625
GoogleCameroon2361576
GoogleCanada2281568
GoogleCatalonia3821722
GoogleCentral African Republic2301570
GoogleChad3541694
GoogleChile2351575
GoogleChina2371577
GoogleColombia2381578
GoogleCongo2311571
GoogleCook Islands2341574
GoogleCosta Rica2391579
GoogleCote D`Ivoire2331573
GoogleCroatia2701610
GoogleCuba2401580
GoogleCzech Republic2411581
GoogleDenmark2441584
GoogleDjibouti2431583
GoogleDominica2451585
GoogleDominican Republic2461586
GoogleEcuador2481588
GoogleEgypt2501590
GoogleEl Salvador3531693
GoogleEstonia2491589
GoogleEthiopia2521592
GoogleFiji2541594
GoogleFinland2531593
GoogleFrance2561596
GoogleGabon2571597
GoogleGambia2631603
GoogleGeorgia2581598
GoogleGermany2421582
GoogleGhana2601600
GoogleGibraltar2611601
GoogleGreece2651605
GoogleGreenland2621602
GoogleGuadeloupe2641604
GoogleGuatemala2661606
GoogleGuernsey2591599
GoogleGuyana2671607
GoogleHaiti2711611
GoogleHonduras2691609
GoogleHong Kong2681608
GoogleHungary2721612
GoogleIceland2781618
GoogleIndia2771617
GoogleIndonesia2731613
GoogleIreland2741614
GoogleIsle of Man2761616
GoogleIsrael2751615
GoogleItalia2791619
GoogleJamaica2811621
GoogleJapan2831623
GoogleJersey2801620
GoogleJordan2821622
GoogleKazakhstan2901630
GoogleKenya2841624
GoogleKiribati2861626
GoogleRepublic of Korea2881628
GoogleKuwait2891629
GoogleKyrgyzstan2871627
GoogleLaos2911631
GoogleLatvia2981638
GoogleLebanon2921632
GoogleLesotho2951635
GoogleLibya2991639
GoogleLiechtenstein2931633
GoogleLithuania2961636
GoogleLuxembourg2971637
GoogleMacedonia3041644
GoogleMadagascar3031643
GoogleMalawi3111651
GoogleMalaysia3131653
GoogleMaldives3101650
GoogleMali3051645
GoogleMalta3081648
GoogleMauritius3091649
GoogleMexico3121652
GoogleMicronesia2551595
GoogleMoldova3011641
GoogleMongolia3061646
GoogleMontenegro3021642
GoogleMontserrat3071647
GoogleMorocco3001640
GoogleMozambique3141654
GoogleNamibia3151655
GoogleNauru3231663
GoogleNepal3221662
GoogleNetherlands3201660
GoogleNew Zealand3251665
GoogleNicaragua3181658
GoogleNiger3191659
GoogleNigeria3171657
GoogleNiue3241664
GoogleNorfolk Island3161656
GoogleNorway3211661
GoogleOman3261666
GooglePakistan3301670
GooglePalestinian Territories3341674
GooglePanama3271667
GoogleParaguay3361676
GooglePeru3281668
GooglePhilippines3291669
GooglePitcairn Islands3321672
GooglePoland3311671
GooglePortugal3351675
GooglePuerto Rico3331673
GoogleQatar3371677
GoogleRomania3381678
GoogleRussia3391679
GoogleRwanda3401680
GoogleSaint Helena3461686
GoogleSaint Vincent and the Grenadines3711711
GoogleSamoa3771717
GoogleSan Marino3511691
GoogleSao Tome and Principe3521692
GoogleSaudi Arabia3411681
GoogleSenegal3501690
GoogleSerbia3781718
GoogleSeychelles3431683
GoogleSierra Leone3491689
GoogleSingapore3451685
GoogleSlovakia3481688
GoogleSlovenia3471687
GoogleSolomon Islands3421682
GoogleSouth Africa3791719
GoogleSpain2511591
GoogleSri Lanka2941634
GoogleSweden3441684
GoogleSwitzerland2321572
GoogleTaiwan3641704
GoogleTajikistan3571697
GoogleTanzania3651705
GoogleThailand3561696
GoogleTimor-Leste3591699
GoogleTogo3551695
GoogleTokelau3581698
GoogleTonga3611701
GoogleTrinidad and Tobago3631703
GoogleTurkey3621702
GoogleTurkmenistan3601700
GoogleUganda3671707
GoogleUkraine3661706
GoogleUnited Arab Emirates2021542
GoogleUnited Kingdom3681708
GoogleUruguay3691709
GoogleUSA2001540
GoogleVanuatu3761716
GoogleVenezuela3721712
GoogleZambia3801720
GoogleZimbabwe3811721
GoogleUzbekistan4691741
GoogleMyanmar4721744
GoogleTunisia18331834
GoogleCyprus (Greece)18251827
GoogleVietnam3751715
GoogleIraq30053008
GoogleReunion29232926
GoogleU.S. Virgin Islands3741714
GooglePapua New Guinea30293032
GoogleBarbados62036206
GoogleAlbania23812382
GoogleLiberia53635366
GoogleCape Verde30233026
GoogleGuinea53695372
GoogleRep. Dem. du Congo2291569
GoogleSomali30353038
GoogleEquatorial Guinea53575360
GoogleBhutan30173020
GoogleFrench Polynesia31703173
GoogleMonaco28393167
GoogleGuinea-Bissau53515354
GoogleSuriname30413044
GoogleTurks and Caicos Islands29442947
GoogleCyprus (Turkey)18261828