# 대량 신규 및 손실 참조 도메인 **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/backlinks/bulk_new_lost_referring_domains/live` **Tags:** DataForSEO `date_from` 이후 여러 `targets`의 신규 및 손실 참조 도메인을 대상별로 반환합니다: `new_referring_domains`, `lost_referring_domains`, `new_referring_main_domains`, `lost_referring_main_domains`. 사이트가 실제로 관계를 늘리고 있는지 판단할 때는 `post_dataforseo_backlinks_bulk_new_lost_backlinks_live`보다 이 엔드포인트를 권장합니다. 도메인은 링크보다 교체가 적기 때문입니다. 이 엔드포인트에는 limit 파라미터가 없어 호출 횟수를 줄이는 것 외에 조절할 수단이 없습니다. ### 가격 참고 - 과금 기준: 응답에 보고된 비용. - 참고 요청 추정치: USD 0.06. - 참고 고객 배수: 1.0. 이미 정산된 고객 금액에는 다시 적용하지 마세요. 참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격, 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "string" }, "description": "신규 및 손실 참조 도메인을 가져올 도메인, 서브도메인 또는 웹페이지입니다.
필수 필드
도메인, 서브도메인 또는 웹페이지를 최대 1,000개까지 설정할 수 있습니다.
도메인이나 서브도메인은 https://와 www. 없이 지정해야 합니다.
페이지는 절대 URL로 지정해야 합니다(http:// 또는 https:// 포함).
예:
`\"targets\": [
\"forbes.com\",
\"cnn.com\",
\"bbc.com\",
\"yelp.com\",
\"https://www.apple.com/iphone/\",
\"https://ahrefs.com/blog/\",
\"ibm.com\",
\"https://variety.com/\",
\"https://stackoverflow.com/\",
\"www.trustpilot.com\"
]`" }, "date_from": { "type": [ "string", "null" ], "description": "시간 범위의 시작 날짜입니다.
선택 필드
이 필드는 신규 및 손실 참조 도메인의 기준일로 사용할 날짜를 나타냅니다.
지정한 날짜 이후 색인에 나타난 참조 도메인은 신규로 간주됩니다.
지정한 날짜 이후에는 발견되지 않았지만 이전에 존재했던 참조 도메인은 손실로 간주됩니다.

기본값: 오늘 날짜에서 한 달 전
예: 오늘이 2021-10-13이면 기본 date_from은 2021-09-13입니다.
최솟값은 오늘 날짜에서 1년 전과 같습니다.
예: 오늘이 2021-10-13이면 최소 date_from은 2020-10-13입니다.

날짜 형식: \"yyyy-mm-dd\"
예:
\"2021-01-01\"" }, "tag": { "type": [ "string", "null" ], "description": "사용자 정의 작업 식별자
선택 필드
최대 255자
이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다
tag에 지정한 값은 응답의 data 객체에서 확인할 수 있습니다" } }, "example": [ { "targets": [ "forbes.com", "cnn.com", "bbc.com", "yelp.com", "https://www.apple.com/iphone/", "https://ahrefs.com/blog/", "ibm.com", "https://variety.com/", "https://stackoverflow.com/", "www.trustpilot.com" ], "datetime_from": "2026-12-31" } ] } ] }, "example": [ { "targets": [ "forbes.com", "cnn.com", "bbc.com", "yelp.com", "https://www.apple.com/iphone/", "https://ahrefs.com/blog/", "ibm.com", "https://variety.com/", "https://stackoverflow.com/", "www.trustpilot.com" ], "datetime_from": "2026-12-31" } ] } ``` ## Responses ### 200 — 작업 성공 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResponseInfo" } ] } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveItem `#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveItem` ```json { "type": "object", "properties": { "target": { "type": [ "string", "null" ], "description": "POST 배열의 도메인, 하위 도메인 또는 웹페이지" }, "new_referring_domains": { "type": [ "integer", "null" ], "description": "신규 참조 도메인 수
target을 가리키는 신규 참조 도메인 수", "format": "int64" }, "lost_referring_domains": { "type": [ "integer", "null" ], "description": "손실된 참조 도메인 수
target의 손실된 참조 도메인 수", "format": "int64" }, "new_referring_main_domains": { "type": [ "integer", "null" ], "description": "target을 가리키는 신규 참조 기본 도메인 수", "format": "int64" }, "lost_referring_main_domains": { "type": [ "integer", "null" ], "description": "target을 가리키는 손실된 참조 기본 도메인 수", "format": "int64" } } } ``` ### Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResponseInfo `#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveTaskInfo" } ] }, "description": "작업 배열" } } } ] } ``` ### Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResultInfo `#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResultInfo` ```json { "type": "object", "properties": { "items_count": { "type": [ "integer", "null" ], "description": "items 배열에 반환된 결과 수", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveItem" } ] }, "description": "관련 백링크 및 참조 도메인 데이터를 포함합니다" } } } ``` ### Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveTaskInfo `#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResultInfo" } ] }, "description": "결과 배열" } } } ] } ``` ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "API의 현재 버전" }, "status_code": { "type": [ "integer", "null" ], "description": "일반 상태 코드입니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다." }, "status_message": { "type": [ "string", "null" ], "description": "일반 정보 메시지입니다.\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다." }, "time": { "type": [ "string", "null" ], "description": "총 실행 시간(초)" }, "cost": { "type": [ "number", "null" ], "description": "전체 작업 비용, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "tasks 배열의 작업 수", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "오류와 함께 반환된 tasks 배열의 작업 수", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "작업 식별자\n시스템 내 고유 작업 식별자(UUID 형식)" }, "status_code": { "type": [ "integer", "null" ], "description": "작업의 상태 코드\nDataForSEO가 생성하며 10000-60000 범위일 수 있습니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다." }, "status_message": { "type": [ "string", "null" ], "description": "작업의 정보 메시지\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다." }, "time": { "type": [ "string", "null" ], "description": "실행 시간, 초" }, "cost": { "type": [ "number", "null" ], "description": "전체 작업 비용, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "result 배열의 요소 수", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL 경로" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "POST 요청에 지정한 것과 동일한 매개변수를 포함합니다" } } } ```