플랫폼 가용성
- 24시간 상태
- 87%
최근 30일
제공 기능
각 Facebook 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword로 Facebook 게시물을 검색하고 게시물별 본문, 작성자, 좋아요·댓글·공유 수, 작성 시간을 가져오며, 날짜 범위를 선택적으로 지정할 수 있습니다. | 요청 1,000개당 $1610행마다 호출 1회로 계산 | 양호 · 상태 100% |
상세 정보profile | url로 Facebook 페이지나 공개 프로필을 가져옵니다. | 요청 1,000개당 $2.78 | 정상 |
사용자 게시물user_posts | url의 Facebook 페이지나 계정 게시물을 나열하며, 게시물별 본문, 작성자, 작성 시간, 좋아요·댓글·공유 수를 포함합니다. | 요청 1,000개당 $2.78 | 정상 |
게시물 상세 정보post | url로 Facebook 게시물 하나를 가져오며 본문, 작성자, 작성 시간, 좋아요·댓글·공유 수를 포함합니다. | 요청 1,000개당 $1.39 | 사용 가능 · 상태 83% |
댓글comments | url로 Facebook 게시물의 댓글을 가져옵니다. | 요청 1,000개당 $2.78 | 정상 |
팔로워followers | username으로 Facebook 계정이나 페이지의 팔로워, 팔로잉, 게시물, 좋아요 수를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
광고ads | keyword나 광고 라이브러리 URL로 Facebook 광고 라이브러리의 광고를 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
그룹 게시물group_posts | 그룹 url이나 식별자로 Facebook 그룹의 게시물을 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
마켓플레이스marketplace | keyword로 한 도시의 Facebook Marketplace 상품 정보를 탐색합니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | Facebook 페이지 url에서 추천과 리뷰를 수집하며, 본문, 추천 여부, 평점(있는 경우), 작성자, 작성 시간을 포함합니다. | 요청 1,000개당 $1.39 | 정상 |
광고주 검색advertiser_search | 광고 라이브러리에서 브랜드나 광고주 이름으로 광고하는 Facebook 페이지를 호출당 최대 15개까지 찾습니다. | 요청 1,000개당 $0.88 | 정상 |
광고 상세 정보ad_detail | 링크나 Library ID로 Facebook 광고 라이브러리의 광고 하나를 엽니다. | 요청 1,000개당 $0.96 | 정상 |
이벤트 검색events_search | music festival 같은 keyword로 공개 Facebook 이벤트를 검색합니다. | 요청 1,000개당 $0.96 | 정상 |
마켓플레이스 상품 상세 정보marketplace_item | 링크나 숫자 ID로 Facebook Marketplace 상품 정보 하나를 조회합니다. | 요청 1,000개당 $0.96 | 정상 |
페이지 이벤트page_events | 페이지 링크에서 공개 Facebook 페이지가 주최하는 예정된 이벤트와 지난 이벤트를 나열합니다. | 요청 1,000개당 $0.96 | 정상 |
동영상 게시물 스크립트post_transcript | 링크로 공개 Facebook 동영상, 릴스, 동영상 게시물의 음성을 텍스트로 변환합니다. | 요청 1,000개당 $0.96 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Facebook 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | content_type, since, until | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1610행마다 호출 1회로 계산 | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
profile상세 정보
| url | — | Async 응답 | — | 요청 1,000개당 $2.78 | id · name · url · bio · category · like_count · follower_count · is_verified · phone · email · website · rating · rating_scale · avatar_url · platform |
user_posts사용자 게시물
| url | — | Async 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $2.78 | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
post게시물 상세 정보
| url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
comments댓글
| url | — | Async 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $2.78 | id · text · author_name · author_username · depth · reply_to_id · comment_url · author_id · author_url · like_count · reply_count · posted_at · platform |
followers팔로워
| username | channel | Sync 응답 | — | 요청 1,000개당 $1.39 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
ads광고
| keyword | country, status | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · title · cta_text · link_url · is_active · started_at · ended_at · platforms · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · image_url · platform |
group_posts그룹 게시물 그룹 | url | sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · posted_at · like_count · comment_count · share_count · author_id · author_name · author_url · group_url · platform |
marketplace마켓플레이스
| keyword | location | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · name · price · currency · city · state · condition · image_url · posted_at · platform |
reviews리뷰 Facebook 페이지 | url | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · is_recommended · rating · rating_scale · posted_at · like_count · comment_count · author_id · author_name · author_url · platform |
advertiser_search광고주 검색 광고 라이브러리에서 브랜드나 광고주 이름으로 광고하는 Facebook 페이지를 호출당 최대 15개까지 찾습니다. 각 페이지에는 ID, 이름, 사용자 이름, 카테고리, 인증 여부, 페이지 좋아요 수, 연결된 Instagram 계정과 그 팔로워 수가 포함됩니다. nike를 검색하면 Nike(페이지 ID 15087023444)가 맨 앞에 나옵니다. 페이지네이션은 없습니다. | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=15, maxLimit=15. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 15까지만 적용됩니다. | 요청 1,000개당 $0.88 | id · name · username · url · category · avatar_url · page_like_count · is_verified · instagram_username · instagram_follower_count · instagram_verified · country · platform |
ad_detail광고 상세 정보 링크나 Library ID로 Facebook 광고 라이브러리의 광고 하나를 엽니다. 게재 중인지 여부, 시작일과 종료일, 광고 문구, 헤드라인, 링크와 클릭 유도 문구(CTA), 표시 형식, 게재된 지면, 이미지나 동영상, 모든 크리에이티브 변형, 광고주의 페이지 ID·이름·좋아요 수·카테고리를 가져옵니다. 지출, 도달 범위, 타기팅은 결과에 포함되지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.96 | id · url · is_active · started_at · ended_at · text · title · caption · link_url · link_description · cta_text · display_format · platforms · media · creatives · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · advertiser_avatar_url · advertiser_categories · platform |
events_search이벤트 검색
| keyword | page_token | Sync 응답 | 호출 한 번에 최대 5행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.96 | id · url · name · starts_at · date_text · place_name · place_id · is_online · is_past · going_count · interested_count · price_text · image_url · next_page_token · platform |
marketplace_item마켓플레이스 상품 상세 정보 링크나 숫자 ID로 Facebook Marketplace 상품 정보 하나를 조회합니다. 제목, 설명, 가격과 원래 가격, 통화, 상품 상태, 상품 속성, 좌표를 포함한 위치, 등록 시간, 판매 완료 및 거래 대기 플래그, 배송 및 배달 옵션, 사진, 판매자의 이름·평점·평가 수·가입일을 가져옵니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.96 | id · url · title · text · price · price_text · original_price_text · currency · condition · attributes · location · latitude · longitude · posted_at · is_sold · is_pending · is_shipping_offered · delivery_types · category_id · image_urls · seller_id · seller_name · seller_rating · seller_rating_count · seller_joined_at · platform |
page_events페이지 이벤트 페이지 링크에서 공개 Facebook 페이지가 주최하는 예정된 이벤트와 지난 이벤트를 나열합니다. 이벤트별 이름, 시작 시간, 장소, 도시, 주최자, 온라인 여부, 지난 이벤트 여부, 취소 여부가 포함됩니다. 페이지당 최대 10개이며 개수는 달라질 수 있고, | url | page_token | Sync 응답 | 호출 한 번에 최대 10행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.96 | id · url · name · starts_at · date_text · place_name · city · host_name · is_online · is_past · is_canceled · next_page_token · platform |
post_transcript동영상 게시물 스크립트 링크로 공개 Facebook 동영상, 릴스, 동영상 게시물의 음성을 텍스트로 변환합니다. 스크립트와 초 단위 동영상 길이를 가져옵니다. 말소리가 없는 동영상은 | url | — | Sync 응답 | — | 요청 1,000개당 $0.96 | id · url · text · duration_seconds · duration_sec · platform |
Facebook search 파라미터는 각각 무엇을 의미하나요?
keyword로 Facebook 게시물을 검색하고 게시물별 본문, 작성자, 좋아요·댓글·공유 수, 작성 시간을 가져오며, 날짜 범위를 선택적으로 지정할 수 있습니다. content_type은 미디어를 필터링하지 않고 최신순 또는 인기순으로 정렬하며, 비공개 메시지는 검색하지 않습니다.
keyword필수- 플랫폼 엔드포인트별로 다른 검색어를 지정합니다. search에서는 공개 게시물을 검색하고, ads에서는 광고 키워드, Ad Library URL 또는 Page URL을 직접 받으며, marketplace에서는 상품 검색어 또는 Marketplace 검색 URL 전체를 받습니다. 각 액션은 같은 결과를 다른 필드 이름으로 반환하는 것이 아니라 서로 다른 데이터셋을 조회합니다.
content_type선택- search 액션의 결과를 정렬하며, 허용 값은 최신 게시물순인 latest와 인기 게시물순인 most_popular입니다. 이름과 달리 content_type은 정렬 기준이며, 이미지나 동영상 같은 미디어 형식으로 필터링하지 않습니다.허용 값:
latestmost_popularFacebook: 공개 게시물과 공개 정보의 범위 — Facebook 고객센터 문서는 공개 공유, 페이지 게시물, 공개 게시물에 달린 댓글의 공개 범위를 정의합니다. 이는 검색 대상 객체를 명확히 할 뿐이며, `content_type` 순위 값을 보증하거나 공개된 정보의 자동 수집이 허가되었음을 보여주지는 않습니다. · 확인일 since선택- search 액션에서 이 시작일부터 게시된 게시물로 필터링하며, YYYY-MM-DD 형식을 권장합니다. until과 함께 조회 기간을 구성하며, 광고 게재 기간이나 댓글 작성 시간은 필터링하지 않습니다.
until선택- search 액션에서 이 종료일까지 게시된 게시물로 필터링하며, YYYY-MM-DD 형식을 권장합니다. since와 함께 조회 기간을 구성하며, 광고 만료일은 제어하지 않습니다.
Facebook profile 파라미터는 각각 무엇을 의미하나요?
url로 Facebook 페이지나 공개 프로필을 가져옵니다. 카테고리, 소개, 좋아요 수, 팔로워 수, 인증 배지, 표시된 연락처 정보가 포함됩니다. 전화번호와 이메일은 페이지에 표시된 정보일 뿐이며, 해당 정보가 신원을 입증하거나 사용 허가를 의미하지는 않습니다.
url필수- 요청한 액션에 맞는 대상 URL을 지정합니다. profile과 user_posts에는 공개 Page URL, post와 comments에는 게시물 URL, group_posts에는 그룹 페이지 URL 또는 그룹 식별자를 사용합니다. reviews에는 비즈니스 페이지 URL을 사용하며, 시스템이 여기에 /reviews를 추가합니다. 임의의 Facebook URL을 액션 간에 바꿔 사용할 수 없습니다.Facebook 공식 문서: 페이지, 프로필, 게시물, 댓글의 공개 범위 — Meta 공식 문서는 페이지, 프로필, 게시물, 댓글의 공개 정보를 다룹니다. 이러한 공개 범위의 정의가 모든 URL을 읽을 수 있다거나, 모든 필드가 반환된다거나, 이 엔드포인트가 Meta의 접근 권한을 보유하고 있음을 보장하지는 않습니다. · 확인일Meta 공식 문서: 자동화된 데이터 수집에는 사전 허가가 필요하다 — Meta는 공개된 데이터라도 사전 허가 없이 Facebook 데이터를 자동으로 수집하면 약관 위반이라고 명시합니다. 공신력 있는 출처를 인용했다고 해서 플랫폼 데이터 수집이나 재사용이 허가되었다는 증거가 되지는 않습니다. · 확인일
Facebook user_posts 파라미터는 각각 무엇을 의미하나요?
url의 Facebook 페이지나 계정 게시물을 나열하며, 게시물별 본문, 작성자, 작성 시간, 좋아요·댓글·공유 수를 포함합니다. 결과가 전체 타임라인이라는 보장은 없습니다.
url필수- 요청한 액션에 맞는 대상 URL을 지정합니다. profile과 user_posts에는 공개 Page URL, post와 comments에는 게시물 URL, group_posts에는 그룹 페이지 URL 또는 그룹 식별자를 사용합니다. reviews에는 비즈니스 페이지 URL을 사용하며, 시스템이 여기에 /reviews를 추가합니다. 임의의 Facebook URL을 액션 간에 바꿔 사용할 수 없습니다.Facebook 공식 문서: 페이지, 프로필, 게시물, 댓글의 공개 범위 — Meta 공식 문서는 페이지, 프로필, 게시물, 댓글의 공개 정보를 다룹니다. 이러한 공개 범위의 정의가 모든 URL을 읽을 수 있다거나, 모든 필드가 반환된다거나, 이 엔드포인트가 Meta의 접근 권한을 보유하고 있음을 보장하지는 않습니다. · 확인일Meta 공식 문서: 자동화된 데이터 수집에는 사전 허가가 필요하다 — Meta는 공개된 데이터라도 사전 허가 없이 Facebook 데이터를 자동으로 수집하면 약관 위반이라고 명시합니다. 공신력 있는 출처를 인용했다고 해서 플랫폼 데이터 수집이나 재사용이 허가되었다는 증거가 되지는 않습니다. · 확인일
Facebook post 파라미터는 각각 무엇을 의미하나요?
url로 Facebook 게시물 하나를 가져오며 본문, 작성자, 작성 시간, 좋아요·댓글·공유 수를 포함합니다. 댓글, 세부 반응, 비공개 콘텐츠는 포함되지 않습니다. 댓글 스레드는 comments를 사용하세요.
url필수- 요청한 액션에 맞는 대상 URL을 지정합니다. profile과 user_posts에는 공개 Page URL, post와 comments에는 게시물 URL, group_posts에는 그룹 페이지 URL 또는 그룹 식별자를 사용합니다. reviews에는 비즈니스 페이지 URL을 사용하며, 시스템이 여기에 /reviews를 추가합니다. 임의의 Facebook URL을 액션 간에 바꿔 사용할 수 없습니다.Facebook 공식 문서: 페이지, 프로필, 게시물, 댓글의 공개 범위 — Meta 공식 문서는 페이지, 프로필, 게시물, 댓글의 공개 정보를 다룹니다. 이러한 공개 범위의 정의가 모든 URL을 읽을 수 있다거나, 모든 필드가 반환된다거나, 이 엔드포인트가 Meta의 접근 권한을 보유하고 있음을 보장하지는 않습니다. · 확인일Meta 공식 문서: 자동화된 데이터 수집에는 사전 허가가 필요하다 — Meta는 공개된 데이터라도 사전 허가 없이 Facebook 데이터를 자동으로 수집하면 약관 위반이라고 명시합니다. 공신력 있는 출처를 인용했다고 해서 플랫폼 데이터 수집이나 재사용이 허가되었다는 증거가 되지는 않습니다. · 확인일
Facebook comments 파라미터는 각각 무엇을 의미하나요?
url로 Facebook 게시물의 댓글을 가져옵니다. 댓글별 작성자, 작성자 ID, 좋아요 수, 답글 수, 작성 시간, 고유 링크가 포함됩니다. 답글 행은 상위 그룹의 ID를 그대로 사용하므로 depth와 reply_to_id로 스레드를 재구성하세요. 전체 트리가 모두 포함된다는 보장은 없습니다.
url필수- 요청한 액션에 맞는 대상 URL을 지정합니다. profile과 user_posts에는 공개 Page URL, post와 comments에는 게시물 URL, group_posts에는 그룹 페이지 URL 또는 그룹 식별자를 사용합니다. reviews에는 비즈니스 페이지 URL을 사용하며, 시스템이 여기에 /reviews를 추가합니다. 임의의 Facebook URL을 액션 간에 바꿔 사용할 수 없습니다.Facebook 공식 문서: 페이지, 프로필, 게시물, 댓글의 공개 범위 — Meta 공식 문서는 페이지, 프로필, 게시물, 댓글의 공개 정보를 다룹니다. 이러한 공개 범위의 정의가 모든 URL을 읽을 수 있다거나, 모든 필드가 반환된다거나, 이 엔드포인트가 Meta의 접근 권한을 보유하고 있음을 보장하지는 않습니다. · 확인일Meta 공식 문서: 자동화된 데이터 수집에는 사전 허가가 필요하다 — Meta는 공개된 데이터라도 사전 허가 없이 Facebook 데이터를 자동으로 수집하면 약관 위반이라고 명시합니다. 공신력 있는 출처를 인용했다고 해서 플랫폼 데이터 수집이나 재사용이 허가되었다는 증거가 되지는 않습니다. · 확인일
Facebook followers 파라미터는 각각 무엇을 의미하나요?
username으로 Facebook 계정이나 페이지의 팔로워, 팔로잉, 게시물, 좋아요 수를 확인합니다. 정밀도 플래그로 근삿값을 표시합니다. 총계만 반환하며 개별 팔로워 목록은 제공하지 않습니다.
username필수- followers 액션에 사용할 Facebook 계정 또는 Page 식별자를 @ 기호 없이 지정합니다. 이 기능은 개별 팔로워 프로필 목록이나 사용자 관계 그래프가 아니라 총 팔로워 수 객체를 반환합니다.Facebook: 페이지 팔로우는 좋아요와 다르다 — Facebook 공식 문서는 팔로우가 페이지 업데이트를 받기 위한 기능이라고 설명하고, 좋아요 구조에서 팔로우 구조로 전환 중인 페이지의 차이점을 안내합니다. 이를 통해 `follower_count`와 `like_count`를 구분할 수 있지만, 이 플랫폼이 팔로워 목록을 내보낼 수 있다는 의미는 아닙니다. · 확인일
channel선택- followers 액션의 계정 식별자와 호환되도록 제공하는 파라미터입니다. username을 지정하면 username이 우선하며, 공개 요청에는 여전히 필수 파라미터인 username을 포함해야 합니다. 채팅 채널 ID를 의미하지 않습니다.
Facebook ads 파라미터는 각각 무엇을 의미하나요?
keyword나 광고 라이브러리 URL로 Facebook 광고 라이브러리의 광고를 찾습니다. 광고 문구, CTA, 랜딩 페이지, 게재 기간, 게재 지면, 광고주를 가져옵니다. 국가와 status로 범위를 좁힐 수 있습니다. 지출, 노출 수, 타기팅, 전환은 포함되지 않습니다.
keyword필수- 플랫폼 엔드포인트별로 다른 검색어를 지정합니다. search에서는 공개 게시물을 검색하고, ads에서는 광고 키워드, Ad Library URL 또는 Page URL을 직접 받으며, marketplace에서는 상품 검색어 또는 Marketplace 검색 URL 전체를 받습니다. 각 액션은 같은 결과를 다른 필드 이름으로 반환하는 것이 아니라 서로 다른 데이터셋을 조회합니다.Meta 공식 문서: 광고 라이브러리의 광고 및 페이지 검색 대상 — 과거 Meta 공지는 키워드나 페이지로 광고를 검색하는 기능을 소개하고, 일반 활성 광고와 정치·사회 이슈 광고 간의 투명성 데이터 차이 및 공식 API 요건을 강조합니다. 그렇다고 모든 광고에 지출액, 노출수, 전체 기록이 포함된다는 뜻은 아니며, 이 엔드포인트는 이러한 필드를 안정적으로 제공하지 않습니다. · 확인일
country선택- ads 액션의 키워드 조회에 사용할 국가 코드를 지정합니다(예: US, 기본값 US). 요청 URL을 구성할 때 값은 대문자로 변환됩니다. keyword를 전체 URL로 지정하면 해당 URL에 포함된 파라미터가 우선하며 이 국가 설정은 적용되지 않습니다.
status선택- 광고 페이지 상태를 필터링하며, 허용 값은 all(기본값), active(현재 게재 중), inactive(중단됨)입니다. 광고 심사 상태가 아니라 광고 게재 상태를 의미합니다. keyword가 Ad Library URL이면 URL에 포함된 active_status가 이 파라미터와 다를 수 있으므로 두 값을 일치시켜야 합니다.
Facebook group_posts 파라미터는 각각 무엇을 의미하나요?
그룹 url이나 식별자로 Facebook 그룹의 게시물을 조회합니다. 본문, 작성자, 작성 시간, 좋아요·댓글·공유 수를 가져옵니다. sort로 인기 게시물 또는 최근 활동을 선택합니다. 최근 활동은 작성 시간이 아닌 활동 시점을 기준으로 합니다. 모든 게시물이 포함된다는 보장은 없습니다.
url필수- 요청한 액션에 맞는 대상 URL을 지정합니다. profile과 user_posts에는 공개 Page URL, post와 comments에는 게시물 URL, group_posts에는 그룹 페이지 URL 또는 그룹 식별자를 사용합니다. reviews에는 비즈니스 페이지 URL을 사용하며, 시스템이 여기에 /reviews를 추가합니다. 임의의 Facebook URL을 액션 간에 바꿔 사용할 수 없습니다.Meta 공식 문서: 그룹이 공개로 전환되어도 과거 비공개 콘텐츠는 계속 보호된다 — Meta 공식 문서에 따르면 비공개 그룹이 공개로 전환되면 새 콘텐츠는 공개되지만, 비공개 기간의 콘텐츠와 멤버 목록은 계속 제한됩니다. 따라서 현재 공개 상태인 그룹이라도 과거 게시물이나 전체 멤버 목록에 대한 접근은 보장되지 않습니다. · 확인일Meta 공식 문서: 자동화된 데이터 수집에는 사전 허가가 필요하다 — Meta는 공개된 데이터라도 사전 허가 없이 Facebook 데이터를 자동으로 수집하면 약관 위반이라고 명시합니다. 공신력 있는 출처를 인용했다고 해서 플랫폼 데이터 수집이나 재사용이 허가되었다는 증거가 되지는 않습니다. · 확인일
sort선택- group_posts의 게시물 정렬 순서로, 인기 게시물은 top, 최근 활동이 있는 게시물은 recent를 지정하며, 생략하면 시간순으로 정렬됩니다. recent 옵션은 게시물 작성 시간만이 아니라 활동을 기준으로 합니다. 지원하지 않는 문자열 값은 오류를 반환하지 않고 시간순 정렬로 대체됩니다.
Facebook marketplace 파라미터는 각각 무엇을 의미하나요?
keyword로 한 도시의 Facebook Marketplace 상품 정보를 탐색합니다. 가격, 통화, 도시, 주, 상품 상태, 이미지, 게시 시간을 가져옵니다. location에는 도로명 주소가 아닌 nyc(기본값) 같은 도시 경로를 넣습니다. 구매 가능 여부는 확인되지 않습니다.
keyword필수- 플랫폼 엔드포인트별로 다른 검색어를 지정합니다. search에서는 공개 게시물을 검색하고, ads에서는 광고 키워드, Ad Library URL 또는 Page URL을 직접 받으며, marketplace에서는 상품 검색어 또는 Marketplace 검색 URL 전체를 받습니다. 각 액션은 같은 결과를 다른 필드 이름으로 반환하는 것이 아니라 서로 다른 데이터셋을 조회합니다.
location선택- marketplace에 사용할 도시 경로 식별자를 지정합니다(예: nyc, 기본값 nyc). 자유 형식 주소는 받지 않습니다. keyword에 Marketplace URL 전체가 포함되어 있으면 해당 URL이 우선하며 location은 무시됩니다.Meta 공식 문서: Marketplace 상품 정보와 위치 검색 범위 — 과거 Meta 문서는 Marketplace를 지역 내 상품 등록과 탐색을 위한 기능으로 정의하고, 상품명, 가격, 위치를 구분합니다. 이는 해당 객체를 설명할 뿐이며, 플랫폼 자체 UI의 필터 옵션이나 과거의 지역별 제공 여부가 이 엔드포인트의 현재 기능이라는 근거가 되지는 않습니다. · 확인일
Facebook reviews 파라미터는 각각 무엇을 의미하나요?
Facebook 페이지 url에서 추천과 리뷰를 수집하며, 본문, 추천 여부, 평점(있는 경우), 작성자, 작성 시간을 포함합니다. Facebook은 별점 대신 추천 여부를 사용하므로 평점이 없어도 추천은 유효합니다.
url필수- 요청한 액션에 맞는 대상 URL을 지정합니다. profile과 user_posts에는 공개 Page URL, post와 comments에는 게시물 URL, group_posts에는 그룹 페이지 URL 또는 그룹 식별자를 사용합니다. reviews에는 비즈니스 페이지 URL을 사용하며, 시스템이 여기에 /reviews를 추가합니다. 임의의 Facebook URL을 액션 간에 바꿔 사용할 수 없습니다.Facebook 공식 문서: 페이지 추천과 리뷰 — 공식 문서는 추천이 페이지의 리뷰 섹션에 표시되며, 정책을 위반한 리뷰를 삭제하면 페이지 평점이 바뀔 수 있다고 설명합니다. 페이지 전체 평점은 개별 추천 항목과 별개이므로 `is_recommended`를 별점으로 자동 변환할 수 없습니다. · 확인일Meta 공식 문서: 자동화된 데이터 수집에는 사전 허가가 필요하다 — Meta는 공개된 데이터라도 사전 허가 없이 Facebook 데이터를 자동으로 수집하면 약관 위반이라고 명시합니다. 공신력 있는 출처를 인용했다고 해서 플랫폼 데이터 수집이나 재사용이 허가되었다는 증거가 되지는 않습니다. · 확인일
Facebook advertiser_search 파라미터는 각각 무엇을 의미하나요?
광고 라이브러리에서 브랜드나 광고주 이름으로 광고하는 Facebook 페이지를 호출당 최대 15개까지 찾습니다. 각 페이지에는 ID, 이름, 사용자 이름, 카테고리, 인증 여부, 페이지 좋아요 수, 연결된 Instagram 계정과 그 팔로워 수가 포함됩니다. nike를 검색하면 Nike(페이지 ID 15087023444)가 맨 앞에 나옵니다. 페이지네이션은 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- 브랜드 또는 광고주 이름입니다(예:
nike). 광고 라이브러리에서 해당 이름으로 광고하는 페이지를 반환하며, 각id는 페이지 ID입니다.
Facebook ad_detail 파라미터는 각각 무엇을 의미하나요?
링크나 Library ID로 Facebook 광고 라이브러리의 광고 하나를 엽니다. 게재 중인지 여부, 시작일과 종료일, 광고 문구, 헤드라인, 링크와 클릭 유도 문구(CTA), 표시 형식, 게재된 지면, 이미지나 동영상, 모든 크리에이티브 변형, 광고주의 페이지 ID·이름·좋아요 수·카테고리를 가져옵니다. 지출, 도달 범위, 타기팅은 결과에 포함되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 광고 하나를 지정합니다. 광고 라이브러리 링크(https://www.facebook.com/ads/library/?id=<Library ID>) 또는 숫자형 라이브러리 ID 자체(
ads행의id)를 입력합니다.
Facebook events_search 파라미터는 각각 무엇을 의미하나요?
music festival 같은 keyword로 공개 Facebook 이벤트를 검색합니다. 이벤트별 이름, 시작 시간, Facebook에 표시된 날짜, 장소, 온라인 여부, 지난 이벤트 여부, 참석 및 관심 인원 수, 표시되는 경우 티켓 가격 텍스트, 커버 이미지가 포함됩니다. 지난 이벤트도 포함됩니다. 페이지당 약 5개이며 next_page_token으로 다음 페이지를 가져옵니다.
keyword필수- 공개 이벤트를 검색할 단어입니다(예:
music festival,yoga Singapore). 지난 이벤트도 포함되므로is_past를 확인하세요. page_token선택events_search와page_events용 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 다시 전달합니다. 마지막 페이지에는 이 값이 없습니다.
Facebook marketplace_item 파라미터는 각각 무엇을 의미하나요?
링크나 숫자 ID로 Facebook Marketplace 상품 정보 하나를 조회합니다. 제목, 설명, 가격과 원래 가격, 통화, 상품 상태, 상품 속성, 좌표를 포함한 위치, 등록 시간, 판매 완료 및 거래 대기 플래그, 배송 및 배달 옵션, 사진, 판매자의 이름·평점·평가 수·가입일을 가져옵니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 상품 정보 하나를 지정합니다. Marketplace 상품 링크(https://www.facebook.com/marketplace/item/<ID>/) 또는 숫자형 상품 ID(
marketplace행의id)를 입력합니다.
Facebook page_events 파라미터는 각각 무엇을 의미하나요?
페이지 링크에서 공개 Facebook 페이지가 주최하는 예정된 이벤트와 지난 이벤트를 나열합니다. 이벤트별 이름, 시작 시간, 장소, 도시, 주최자, 온라인 여부, 지난 이벤트 여부, 취소 여부가 포함됩니다. 페이지당 최대 10개이며 개수는 달라질 수 있고, next_page_token으로 다음 페이지를 가져옵니다. 주최한 이벤트가 없는 페이지는 빈 목록을 반환합니다.
url필수- 공개 페이지 링크입니다(예: https://www.facebook.com/brickyardoldtown). /p/<name>-<ID> 링크도 사용할 수 있습니다.
page_token선택events_search와page_events용 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 다시 전달합니다. 마지막 페이지에는 이 값이 없습니다.
Facebook post_transcript 파라미터는 각각 무엇을 의미하나요?
링크로 공개 Facebook 동영상, 릴스, 동영상 게시물의 음성을 텍스트로 변환합니다. 스크립트와 초 단위 동영상 길이를 가져옵니다. 말소리가 없는 동영상은 text 없이 반환됩니다.
url필수- 공개 동영상, 릴스 또는 동영상 게시물 링크입니다(예: https://www.facebook.com/reel/<ID>/).
Facebook API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"facebook","action":"search","params":{"keyword":"<keyword>"}}'
Facebook 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
멀티 플랫폼 평판 모니터링 설계도: 부정 여론의 변화를 평가하기 전에 범위부터 정의하기
대상 목록, 댓글 식별자, 증분 커서에서 출발해 추적 가능한 평판 모니터링 워크플로를 설계하고, 오프라인 샘플로 중복 제거와 수집 누락을 보여 주며, 사람의 검토 단계를 유지합니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기Facebook API 자주 묻는 질문
Facebook API로 무엇을 가져올 수 있나요?
platform을 facebook 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상세 정보, 사용자 게시물, 게시물 상세 정보, 댓글 및 more입니다. 각 액션 이름은 서로 다른 Facebook 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Facebook에 공식 API가 있나요?
네. Meta의 Graph API가 공식 인터페이스입니다. 앱이 관리하지 않는 Facebook 페이지의 공개 게시물과 댓글을 읽으려면 Page Public Content Access 기능이 필요하며, Meta는 앱 검수와 비즈니스 인증을 거친 경우에만 이 기능을 부여합니다. 개인의 타임라인은 본인의 허락이 있을 때 제한된 용도로만 이용할 수 있습니다.
공식 출처: Meta: Page Public Content Access · Meta Graph API · 확인일
Facebook 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. Facebook 개발자 앱을 등록하거나, Facebook API 접근을 신청하거나, Facebook 계정으로 로그인할 필요가 없으며, 액션은 공개된 Facebook 데이터만 반환합니다.
Facebook API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $0.88부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
Facebook search 요청에는 어떤 입력이 필요한가요?
플랫폼 엔드포인트별로 다른 검색어를 지정합니다. search에서는 공개 게시물을 검색하고, ads에서는 광고 키워드, Ad Library URL 또는 Page URL을 직접 받으며, marketplace에서는 상품 검색어 또는 Marketplace 검색 URL 전체를 받습니다. 각 액션은 같은 결과를 다른 필드 이름으로 반환하는 것이 아니라 서로 다른 데이터셋을 조회합니다. params 안의 keyword 필드로 전달하세요.
Facebook search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 text, author_name, author_username 및 author_id입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Facebook 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답 및 async 응답입니다.