데이터 API / DataForSEO / SERP
Live Google Organic SERP HTML
Returns the ranked results for a keyword on Google, synchronously. Raw page source rather than parsed results. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.
파라미터
경로, 쿼리, 헤더 파라미터가 없습니다.
요청 본문
urlstring선택Direct URL of the search query
location_namestring선택Full name of search engine location
location_codeinteger선택Search engine location code
location_coordinatestring선택GPS coordinates of a location
language_namestring선택Full name of search engine language
language_codestring선택Search engine language code
devicestring선택Device type: desktop or mobile
osstring선택Device operating system
se_domainstring선택Custom search engine domain
depthinteger선택Parsing depth, default 100, max 700
max_crawl_pagesinteger선택Page crawl limit, max 100
search_paramstring선택Additional parameters of the search query
load_async_ai_overviewboolean선택Load asynchronous AI overview
expand_ai_overviewboolean선택Expand AI overview item
tagstring선택User-defined task identifier
keywordstring선택Keyword to search for.
요청 예시
curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "<string>",
"location_name": "<string>",
"location_code": 0,
"location_coordinate": "<string>",
"language_name": "<string>",
"language_code": "<string>",
"device": "<string>",
"os": "<string>"
}'응답
응답 필드
versionstring선택API version
status_codeinteger선택General status code
status_messagestring선택General informational message
timestring선택Execution time
costnumber선택Request cost in USD
tasks_countinteger선택Number of tasks returned
tasks_errorinteger선택Number of tasks returned with an error
tasksstring선택Array of live task objects
idstring선택Task identifier
resultstring선택Result array containing HTML pages
itemsstring선택HTML page items
htmlstring선택Raw HTML page content