CA
Crawlee & Apify•2y ago
dependent-tan

Questions about FacebookAds actor results

Hi everyone,  I am currently evaluating the Apify Facebook Ad Actor for a client project, however I have many questions about the data returned by the scraper and I can't find any reliable doc/infos. Here are my main questions: - For now, it seems that the scraper canot load images and data of private pages. Is there any plan to support that ? - adid field is always set to "0". With that name, I would expect it to be the unique id of the app. Can you tell me what this field is for ? - adArchiveID: I'd guess that's the id of the add archive, however its always present, even for ads that are still active. Can you tell me what this field is for ? - Same questions about archiveTypes and categories that contains array of numbers. I can't find any info about what they represent. - pageID, for this one, I guess it's the id of the facebook page associated to the ad ? My question is : is this field always present ? Does it always reference the id of a facebook page or can it reference the id of an instagram page or something else ? - Does entityType represent the type of the facebook page associated to the app ? All infos you can give are very appreciated! It would be very helpful if you could point me to a doc or any resource that describe the content of the actor result, as everything is not easily guessable only by the property name. Thanks a lot for your help ! Maxim
2 Replies
MEE6
MEE6•2y ago
@Max just advanced to level 1! Thanks for your contributions! 🎉
dependent-tan
dependent-tanOP•2y ago
For now, I ran the actor and extracted some data and I deduced the next typescript type:  
export type ApifyValidMetaAd = {
  adid: string;
  adArchiveID: string;
  archiveTypes: number[];
  categories: number[];
  collationCount: number | null;
  collationID: number | null | string;
  currency: Currency | null;
  endDate: number;
  entityType: EntityType;
  fevInfo: FevInfo | null;
  gatedType: GatedType;
  hasUserReported: boolean;
  hiddenSafetyData: boolean;
  hideDataStatus: HideDataStatus;
  impressionsWithIndex: ImpressionsWithIndex;
  isAAAEligible: boolean;
  isActive: boolean;
  isProfilePage: boolean;
  pageID: string;
  pageInfo: null;
  pageIsDeleted: boolean;
  pageName: string;
  politicalCountries: string[];
  reachEstimate: null | string;
  reportCount: null;
  snapshot: Snapshot;
  spend: null | string;
  startDate: number | null;
  stateMediaRunLabel: null;
  publisherPlatform: PublisherPlatform[];
  menuItems: any[];
  endDateFormatted: Date;
  startDateFormatted: Date;
  totalCount: number;
  ageGenderData?: AgeGenderDatum[] | null;
  currencyMatched?: boolean;
  impressions?: null | string;
  locationData?: LocationDatum[] | null;
  singleCountry?: null;
  spendByCurrency?: SpendByCurrency[] | null;
};

type EntityType = 'regular_page' | 'person_profile' | 'ig_ads_identity';
...
export type ApifyValidMetaAd = {
  adid: string;
  adArchiveID: string;
  archiveTypes: number[];
  categories: number[];
  collationCount: number | null;
  collationID: number | null | string;
  currency: Currency | null;
  endDate: number;
  entityType: EntityType;
  fevInfo: FevInfo | null;
  gatedType: GatedType;
  hasUserReported: boolean;
  hiddenSafetyData: boolean;
  hideDataStatus: HideDataStatus;
  impressionsWithIndex: ImpressionsWithIndex;
  isAAAEligible: boolean;
  isActive: boolean;
  isProfilePage: boolean;
  pageID: string;
  pageInfo: null;
  pageIsDeleted: boolean;
  pageName: string;
  politicalCountries: string[];
  reachEstimate: null | string;
  reportCount: null;
  snapshot: Snapshot;
  spend: null | string;
  startDate: number | null;
  stateMediaRunLabel: null;
  publisherPlatform: PublisherPlatform[];
  menuItems: any[];
  endDateFormatted: Date;
  startDateFormatted: Date;
  totalCount: number;
  ageGenderData?: AgeGenderDatum[] | null;
  currencyMatched?: boolean;
  impressions?: null | string;
  locationData?: LocationDatum[] | null;
  singleCountry?: null;
  spendByCurrency?: SpendByCurrency[] | null;
};

type EntityType = 'regular_page' | 'person_profile' | 'ig_ads_identity';
...

Did you find this page helpful?