API de marketing

Búsqueda de segmentación

Segmenta conjuntos de anuncios en función de varios de los criterios proporcionados en las especificaciones de segmentación. La mayoría de los destinos son valores predefinidos, como el país, "Japón", o la ciudad, "Tokio".

Busca valores válidos con la API de marketing y la búsqueda de segmentación: https://graph.facebook.com/{API_VERSION}/search. Debes proporcionar la cadena de consulta en formato UTF8.

Estado de la opción de segmentación

Para verificar el estado actual o planificado de los objetos de segmentación, utiliza el parámetro targeting_option_list:

curl -G \
  -d 'targeting_option_list=[<TARGETING_OPTION_ ID>,<TARGETING_OPTION_ID>]' 
  -d 'type=targetingoptionstatus'  
  https://graph.facebook.com/<API_VERSION>/search

La respuesta:

{"data":[{"id":"<TARGETING_OPTION_ ID>","current_status":"NON-DELIVERABLE"},{"id":"<TARGETING_OPTION_ID>","current_status":"NON-DELIVERABLE","future_plan":[{"key":"2018-05-10T00:00:00+0000","value":"DEPRECATING"}]}]

Campos devueltos

CampoValor

current_status

  • NORMAL
  • NON-DELIVERABLE: no se realiza la entrega, aunque el conjunto de anuncios se puede seguir entregando de acuerdo con las reglas predeterminadas.
  • DEPRECATING: los conjuntos de anuncios dirigidos a este objetivo se siguen entregando, pero el objeto no se puede utilizar para crear ni actualizar conjuntos de anuncios. Cuando se actualicen, los conjuntos de anuncios con este término se rechazarán, a menos que se elimine dicho término.
  • INCLUSION-ONLY: el objeto no se puede utilizar en las exclusiones de segmentación.
  • UNKNOWN

future_plan

Mapa de marca de tiempo para el estado. Devuelve un mapa de fechas y estados planificados, que son los mismos valores disponibles en current_status.

Datos geográficos

Busca una segmentación por país, grupo de países, ciudad, estado, código postal y otras áreas geográficas en type=adgeolocation. Puedes especificar parámetros opcionales con type=adgeolocation. Para buscar el código de país de Estados Unidos:

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=un' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
  "data": [
    {
      "key": "GB", 
      "name": "United Kingdom", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "AE", 
      "name": "United Arab Emirates", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "UM", 
      "name": "United States Minor Outlying Islands", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }
  ]
}

key es un número fijo único en cada categoría, como los países o grupos de países. Los otros campos, incluido name, están sujetos a cambios. Utiliza key para definir las especificaciones de segmentación.

En la respuesta:

  • Si supports_region es true, significa que este país tiene códigos de región.
  • Si supports_city es true, significa que este país tiene códigos de ciudad.
Nombre Descripción

location_types

tipo: matriz

country, country_group, region, city, zip, geo_market o electoral_district (este último solo en EE. UU).
Se prefiere location_types frente a type=adcountry, etc.

region_id

Tipo: entero

Región en la que se va a realizar la búsqueda

country_code

tipo: cadena

País en el que se va a realizar la búsqueda: country_code=US

Países

Cada país al que puedes dirigirte tiene un código de país. Parámetros opcionales de type=adgeolocation&location_types=['country']:

Nombre Descripción

q

tipo: cadena

Cadena que se utilizará para autocompletar valores. Para que se muestren todos los países con location_types=['country'], deja en blanco q= y establece el límite en un número mayor (limit=1000).

match_country_code

tipo: booleano

Adopta false como valor predeterminado.

Busca el país por el código de país. Establece la correspondencia de país por country_code frente a name.

Grupo de países

Todos los grupos de países tienen un código para buscar y obtener una lista países. Para todos los grupos de países denominados mercosur:

curl -G \
  -d 'location_types=["country_group"]' \
  -d 'type=adgeolocation' \
  -d 'q=mercosur' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
  "data": [
    {
      "key": "mercosur",
      "name": "Mercosur",
      "type": "country_group",
      "country_codes": [
        "BR",
        "AR",
        "UY",
        "PY",
        "VE"
      ],
      "is_worldwide": false,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Si is_worldwide es true, se trata de un grupo de países internacional. Si supports_region es true, el grupo de países tiene códigos de región. Si supports_city es true, el grupo tiene códigos de ciudad.

Regiones

Para buscar todas las regiones que comienzan por el código al:

curl -G \
  -d 'location_types=["region"]' \
  -d 'type=adgeolocation' \
  -d 'q=al' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
  "data": [
    {
      "key": "3843",
      "name": "Alabama",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "3844",
      "name": "Alaska",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "527",
      "name": "Alberta",
      "type": "region",
      "country_code": "CA",
      "country_name": "Canada",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "1089",
      "name": "Alsace",
      "type": "region",
      "country_code": "FR",
      "country_name": "France",
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Opciones de type=adgeolocation&location_types=['region']:

Nombre Descripción

q

tipo: cadena

Cadena que se utilizará para autocompletar valores. Para obtener todos los países con location_types=['region'], no proporciones ningún parámetro (q=) y establece el límite en un número mayor (limit=1000).

Si supports_region es true, puedes dirigirte a esta región. Si supports_city es true, la región tiene códigos de ciudad.

Ciudades

Desde marzo de 2019, hemos vuelto a clasificar varias ciudades en otros roles, pero puedes seguir usando city. La búsqueda devolverá los resultados de lo que se consideraba como ciudad anteriormente.

Para buscar los códigos de todas las ciudades que comienzan por Manhattan:

curl -G \
     -d 'location_types=["city"]' \
     -d 'type=adgeolocation' \
     -d 'q=Manhattan' \
     -d 'access_token=ACCESS_TOKEN' \
     https://graph.facebook.com/VERSION/search

La respuesta:

{
  "data": [
    {
      "key": "2447439",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Kansas",
      "region_id": 3859,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2439596",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Illinois",
      "region_id": 3856,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2479541",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Montana",
      "region_id": 3869,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2428908",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Florida",
      "region_id": 3852,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2703980",
      "name": "Manhattan",
      "type": "subcity",
      "country_code": "US",
      "country_name": "United States",
      "region": "New York",
      "region_id": 3875,
      "supports_region": true,
      "supports_city": true,
      "geo_hierarchy_level": "SUBCITY",
      "geo_hierarchy_name": "BOROUGH"
    },
   ...

Si supports_region es true, la región de esta ciudad está disponible para la segmentación. Si supports_city está establecido en true, significa que esta ciudad está disponible para la segmentación.

Áreas geográficas

Contamos con otras áreas geográficas que puedes usar para la segmentación. Algunas de ellas aún no están definidas, tal como se describe a continuación.

ÁreaDescripción

LARGE_GEO_AREA

Se conoce normalmente como distrito o gobernación y abarca cientos de kilómetros cuadrados o más. Ejemplo: Akkar en Lebanon.

MEDIUM_GEO_AREA

Se conoce normalmente como condado y abarca más de una ciudad. Ejemplo: condado de Henrico en el estado de Virginia de United States.

SMALL_GEO_AREA

Se conoce normalmente como una zona residencial cerca de una ciudad o pueblo. Ejemplo: El Rosario cerca de Marbella en Spain.

SUBCITY

Por ejemplo, un distrito. Ejemplo: Brooklyn en New York.

NEIGHBORHOOD

Área dentro de una ciudad. Ejemplo: Barton Estates, Irving en Texas.

SUBNEIGHBORHOOD

Aún no está disponible.

METRO_AREA

Área densamente poblada que rodea una ciudad más grande. Aún no está disponible.

La jerarquía de áreas geográficas es la siguiente, de la más grande a la más pequeña:

  • REGION
  • LARGE_GEO_AREA
  • MEDIUM_GEO_AREA
  • SMALL_GEO_AREA
  • METRO_AREA
  • CITY
  • SUBCITY
  • NEIGHBORHOOD
  • SUBNEIGHBORHOOD

Código postal

También puedes buscar códigos postales para la segmentación en Facebook. Para la búsqueda de códigos postales, se recomienda utilizar adgeolocation con location_types=['zip']. Visita el Servicio de ayuda de Meta para ver una lista de países con códigos postales admitidos.

Busca códigos postales que comiencen por 9:

curl -G \
  -d 'location_types=["zip"]' \
  -d 'type=adgeolocation' \
  -d 'q=9' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/search

La respuesta:

{
  "data": [
    {
      "key": "US:90028",
      "name": "90028",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Los Angeles",
      "primary_city_id": 2420379,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94110",
      "name": "94110",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Francisco",
      "primary_city_id": 2421836,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94501",
      "name": "94501",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Alameda",
      "primary_city_id": 2417628,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:95190",
      "name": "95190",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Jose",
      "primary_city_id": 2421846,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Configuraciones regionales

Configuraciones regionales que se pueden segmentar por códigos de configuración regional. Para buscar todas las configuraciones regionales que comiencen por en:

curl -G \
  -d 'type=adlocale' \
  -d 'q=en' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
{
      "data": [
        {
          "key": 51, 
          "name": "English (Upside Down)"
        }, 
        {
          "key": 6, 
          "name": "English (US)"
        }, 
        {
          "key": 24, 
          "name": "English (UK)"
        }
      ]
    }
}
Nombre Descripción

q

tipo: cadena

Cadena que se utilizará para autocompletar valores. Para obtener todas las configuraciones regionales, deja este campo en blanco (q=) y establece el límite en un número mayor (limit=1000).

Códigos DMA

Para obtenerlos, especifica type=adgeolocation y location_types=['geo_market'] en tu consulta. Para buscar los códigos DMA que comiencen por "New":

curl -G \
  -d 'location_types=["geo_market"]' \
  -d 'type=adgeolocation' \
  -d 'q=New' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

El resultado:

{
  "data": [
    {
      "key": "DMA:622",
      "name": "New Orleans",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:501",
      "name": "New York",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:533",
      "name": "Hartford &amp; New Haven",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
....
    }
  ]
}

Distritos electorales

Para buscar distritos electorales a los que dirigirte, especifica type=adgeolocation y location_types=['electoral_district']. Para buscar distritos electorales de California:

curl -G \
  -d 'location_types=["electoral_district"]' \
  -d 'type=adgeolocation' \
  -d 'q=California' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
  "data": [
    {
      "key": "US:CA14",
      "name": "California's 14th District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:CA02",
      "name": "California's 2nd District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
 ...
}

Metadatos de geolocalizaciones

Puedes utilizar parámetros opcionales adicionales con type=adgeolocationmeta:

curl -G \
  -d 'cities=[2418779]' \
  -d 'zips=["US:90210"]' \
  -d 'countries=["US","JP"]' \
  -d 'regions=[10]' \
  -d 'type=adgeolocationmeta' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta es un objeto JSON con metadados de las geolocalizaciones especificadas:

{
  "data": {
    "countries": {
      "US": {
        "key": "US", 
        "type": "country", 
        "name": "United States", 
        "supports_city": true, 
        "supports_region": true
      }, 
      "JP": {
        "key": "JP", 
        "type": "country", 
        "name": "Japan", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "regions": {
      "10": {
        "key": "10", 
        "type": "region", 
        "name": "Dubai", 
        "country_code": "AE", 
        "supports_city": true, 
        "supports_region": false
      }
    }, 
    "cities": {
      "2418779": {
        "key": "2418779", 
        "type": "city", 
        "name": "Danville", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "zips": {
      "US:90210": {
        "key": "US:90210", 
        "type": "zip", 
        "name": "90210", 
        "primary_city": "Beverly Hills", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }
  }
}

Opciones:

Nombre Descripción

countries

tipo: cadena

Matriz de códigos de país

regions

tipo: número entero

Matriz de códigos de región

country_groups

tipo: cadena

Matriz de códigos de grupos de países

cities

tipo: número entero

Matriz de claves de ciudad

zips

tipo: cadena

Matriz de códigos postales completos. Por ejemplo, US:92103.

Sugerencias de radio

Para aplicar una segmentación en torno a una ubicación específica, consigue un radio sugerido que llegue a un número de personas suficiente con suggested_radius:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta es un objeto JSON con suggested_radius y distance_unit.

{
  "data": [
    {
      "suggested_radius": 10,
      "distance_unit": "mile"
    }
  ]
}

Ejemplo que recupera suggested_radius con un parámetro distance_unit especificado:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search
{
  "data": [
    {
      "suggested_radius": 16,
      "distance_unit": "kilometer"
    }
  ]
}

Utiliza estos parámetros:

Nombre Descripción

latitude

tipo: flotante

Obligatorio.

Latitud de la ubicación

longitude

tipo: flotante

Obligatorio.

Longitud de la ubicación

distance_unit

tipo: cadena

Opcional.

Unidad de medida, mile o kilometer

Consulta también el tema sobre los anuncios de difusión local para su uso con sugerencias.

Intereses

Envía una solicitud GET al extremo /search y establece type en adinterest y q en el interés específico que quieres buscar:

curl -G \
  -d 'type=adinterest' \
  -d 'q=baseball' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta devolverá los campos siguientes:

Nombre Descripción

id

entero

Identificador de Facebook de la segmentación por intereses

locale

Cadena

Si está disponible, recupera el contenido en el idioma de una configuración regional específica con el formato language_TERRITORY. El valor predeterminado es en_US.

name

cadena

Nombre del interés

path

matriz de cadenas

Incluye la categoría y todas las categorías principales de la segmentación.

Sugerencias de interés

Envía una solicitud GET al extremo /search y establece type en adinterestsuggestion para obtener una lista de los intereses sugeridos en relación con el tuyo.

Ejemplo de consulta

curl -G \
  -d 'interest_list=["Basketball"]' \
  -d 'type=adinterestsuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/search

Ejemplo de respuesta

{
  "data": [
    {
      "id": "6003598240487",
      "name": "la biblia",
      "audience_size": 7419780,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003022269556",
      "name": "Rugby football",
      "audience_size": 13214830,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003146664949",
      "name": "Netball",
      "audience_size": 4333770,
      "path": [
  ],
"description": null
   },
   {
      "id": "6003013291881",
      "name": "Kaizer Chiefs F.C.",
      "audience_size": 1812850,
      "path": [
  ],
      "description": null
  },
  ....
  {
      "id": "6003400886535",
      "name": "espn sportscenter",
      "audience_size": 222960,
      "path": [
  ],
     "description": null
  },
  {
     "id": "6002925969459",
     "name": "watching movies",
     "audience_size": 4630950,
     "path": [
  ],
     "description": null
  },
  {
     "id": "6003214125247",
     "name": "lakers",
     "audience_size": 340360,
     "path": [
  ],
     "description": null
  }

Las opciones son las siguientes:

Nombre Descripción

interest_list

tipo: matriz de cadenas

Obligatorio.

Lista de términos de los que quieres obtener sugerencias. Distingue entre mayúsculas y minúsculas.

Limitaciones

  • En una búsqueda no se devolverán todos los intereses disponibles.
  • El nombre de los intereses se puede cambiar en cualquier momento. Es posible que se produzca un error en la validación del nombre cuando esto suceda. Por lo tanto, se recomienda validar los intereses por interest_fbid_list en lugar de hacerlo por el nombre. Para comprobar si los términos son válidos, realiza la consulta con type=adinterestvalid y el interés que quieres validar:
curl -G \
  -d 'interest_list=["Japan","nonexistantkeyword"]' \
  -d 'type=adinterestvalid' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
  "data": [
    {
      "name": "Japan",
      "valid": true,
      "id": 6003700426513,
      "audience_size": 68310258
    },
    {
      "name": "nonexistantkeyword",
      "valid": false
    }
  ]
}

Opciones:

Nombre Descripción

interest_list

tipo: matriz de cadenas

Obligatorio si no hay ningún parámetro interest_fbid_list.

Lista de términos que se van a validar. Distingue entre mayúsculas y minúsculas.

interest_fbid_list

Tipo: matriz de identificadores

Obligatorio si no hay ningún parámetro interest_list.

Lista de los identificadores que se van a validar.

Intereses

Para explorar los posibles intereses para la segmentación, envía una solicitud GET al extremo /search con type establecido en adTargetingCategory y class, en interests.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=interests' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Limitaciones

  • En una búsqueda no se devolverán todos los intereses disponibles.

Comportamientos

Segmentación basada en las acciones del usuario o en comportamientos de compra pasados. Recupera todas las opciones de segmentación por comportamiento posibles con type=adTargetingCategory&class=behaviors.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=behaviors' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta contiene lo siguiente:

Nombre Descripción

name

tipo: cadena

Nombre de la segmentación por comportamiento

id

tipo: número entero

Identificador de Facebook de la segmentación por comportamiento

audience_size_lower_bound

entero

Tamaño estimado de la audiencia objetivo del límite inferior

audience_size_upper_bound

entero

Tamaño estimado de la audiencia objetivo del límite superior

path

tipo: matriz de cadenas

Categoría y todas las categorías principales de esta segmentación

description

tipo: cadena

Describe la audiencia objetivo.

type

tipo: cadena

Clase de la categoría de segmentación

Datos demográficos

Incluye el lugar de trabajo, la educación, los tipos de puestos y los tipos de situaciones sentimentales. La segmentación también se puede realizar según el tiempo que hace que se ha celebrado un acontecimiento importante: 3 meses, 6 meses y 1 año. Puedes hacer referencia a escuelas que quieras segmentar por el identificador y el nombre.

Para buscar todas las escuelas que comiencen por ha:

curl -G \
  -d 'type=adeducationschool' \
  -d 'q=ha' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

 {
  "data": [
    {
      "name": "Harvard University", 
      "id": 105930651606,
      "coverage": 8395398,
      "subtext": "Cambridge, Massachusetts"
    }, 
    {
      "name": "Hajvery University", 
      "id": 148971135122588,
      "coverage": 124162
    }, 
    {
      "name": "Harvard-Westlake School", 
      "id": 107799365910274,
      "coverage": 14106
    }
  ]
}

Especialidades educativas

Segmenta especialidades por el identificador y el nombre. Para buscar todas las especialidades que comienzan por ph:

curl -G \
  -d 'type=adeducationmajor' \
  -d 'q=ph' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
  "data": [
    {
      "name": "Photography", 
      "id": 108170975877442,
      "coverage": 613618
    }, 
    {
      "name": "Physics", 
      "id": 109279729089828,
      "coverage": 942491
    }, 
    {
      "name": "Philosophy", 
      "id": 108026662559095,
      "coverage": 701271
    }
  ]
}

Empleador

Haz referencia a los empleadores que se pueden segmentar por el identificador y el nombre. Para buscar todos los empleadores que comiencen por mic:

curl -G \
  -d 'type=adworkemployer' \
  -d 'q=mic' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
  "data": [
    {
      "name": "Western Michigan University", 
      "id": 10022826163,
      "coverage": 24366
    }, 
    {
      "name": "University of Michigan", 
      "id": 21105780752,
      "coverage": 17357
    }, 
    {
      "name": "Michigan State University - SPARTANS", 
      "id": 8891783019,
      "coverage": 65853
    }
  ]
}

Cargo

Todos los puestos autodeclarados que se pueden segmentar tienen un identificador y un nombre. Para obtener todos los puestos que incluyen Business Analyst:

curl -G \
  -d 'type=adworkposition' \
  -d 'q=Business Analyst' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta:

{
   "data": [
    {
      "name": "Business Analyst", 
      "id": 105763692790962,
      "coverage": 282124
    }, 
    {
      "name": "Financial Analyst", 
      "id": 112930925387573,
      "coverage": 212889
    }
  ]
}

La respuesta tiene los campos siguientes:

Nombre Descripción

name

tipo: cadena

Nombre de la segmentación demográfica

id

tipo: número entero

Identificador de Facebook de la segmentación demográfica

coverage

tipo: número entero

Tamaño estimado de la audiencia objetivo

subtext

tipo: cadena

Descripción de la audiencia objetivo

Los siguientes parámetros son comunes para esta API. Para obtener información sobre los parámetros de entrada específicos del tipo, consulta los detalles a continuación.

Nombre del parámetro Descripción

q

Obligatorio para la mayoría de los tipos de búsqueda.

Cadena que se utilizará para autocompletar valores.

type

Obligatorio.

Tipos de datos para autocompletar que se van a recuperar. Véase a continuación.

list

Opcional.

Recupera los identificadores globales de Facebook preferidos en lugar de los códigos FIPS. Se admite para adzipcode.

Si se utiliza, el valor debe ser igual a GLOBAL.

limit

Opcional.

Resultados máximos que se devolverán. El valor predeterminado es 8.

En función de la categoría de los datos para autocompletar, proporciona el parámetro type adecuado. Para recuperar configuraciones regionales, especifica type=adlocale. Las categorías válidas son las siguientes:

Valor del parámetro "type" Descripción

adeducationschool

Autocompleta la segmentación por universidades.

adeducationmajor

Autocompleta la segmentación por especialidades universitarias.

adgeolocation

Autocompleta los datos combinados de país, ciudad, estado y código postal.

adgeolocation.adcountry

Autocompleta los datos de país.

adgeolocation.adzipcode

Autocompleta los datos de código postal.

adgeolocation.adgeolocationmeta

Metadatos adicionales para geolocalizaciones

adgeolocation.adradiussuggestion

Devuelve el radio recomendado en torno a la ubicación.

adinterest

Autocompleta la segmentación por configuración regional.

adinterest.adinterestsuggestion

Sugerencias basadas en la segmentación por intereses

adinterest.adinterestvalid

Valida la cadena como una opción de segmentación por intereses válida.

adlocale

Autocompleta la segmentación por configuración regional.

adTargetingCategory

Parámetro q ignorado. Consulta todas las opciones de segmentación posibles para la clase con el parámetro class.
Valores posibles de class: interests, behaviors, demographics, life_events, industries, income, family_statuses, user_device y user_os

adworkemployer

Autocompleta los valores de empresa.

adworkposition

Autocompleta los valores de puesto.

Exploración demográfica

Recupera todas las opciones de segmentación demográfica posibles con type=adTargetingCategory y un parámetro class.

Nombre Descripción

class

tipo: cadena

Especifica una de las siguientes opciones: life_events, industries, income, family_statuses o user_device. Si especificas demographics, se recuperan todas las opciones.


Las opciones de segmentación demográfica no están disponibles en todos los países. Facebook puede devolver distintos resultados, incluidos resultados vacíos, según la configuración de país de origen del usuario que accede al identificador de acceso usado para realizar esta llamada a la API.

La respuesta contiene los campos siguientes:

Nombre Descripción

name

tipo: cadena

Nombre de la segmentación demográfica

id

tipo: número entero

Identificador de Facebook de la segmentación demográfica

audience_size_lower_bound

entero

Tamaño estimado de la audiencia objetivo del límite inferior

audience_size_upper_bound

entero

Tamaño estimado de la audiencia objetivo del límite superior

description

tipo: cadena

Descripción de la audiencia objetivo

type

tipo: cadena

Tipo de dato demográfico. Resulta útil para recuperar todos los datos demográficos.

path

tipo: matriz de cadenas

Incluye la categoría y todas las categorías principales que abarca la segmentación.