Endpoint URL: https://api.alfinsight.com/odata/Contacts

Returns data ALF holds about Contacts in relevant companies. This includes contacts working for Advertisers and Agencies.

OData relations

Expandable entities

These can be fetched along with the Contact data using OData's $expand option.

• JobFunctions - There are many variations of job titles - ALF assigns a common set of job functions to each contact.

Related entities

These require a separate API request based on a single contact. If you know the JobId of a Contact you are interested in, you can fetch related data using URL in the format:

https://api.alfinsight.com/odata/Contacts({JobId})/{Relation}

• Brands - these are brands this contact is determined to be responsible for by the ALF research team.
• Company - the details of the contact's company.
• JobFunctions - set of common Job Functions describing the Contact's job roles.

Field Specifications

Key field(s): JobId

To fetch details for one Contact using the key field(s), call the endpoint with URL in format: /odata/Contacts({JobId})

Job Functions are expandable, so you can fetch them with Contact data in one request like this:

You can also fetch them for one contact in this format:

This will only return the Job Functions data.

Field Specifications

Key field(s): JobId, JobCode

To fetch details for one Job Function using the key field(s), call the endpoint with URL in format: /odata/JobFunctions({JobId}, {JobCode})

You can fetch the brands a Contact is responsible for with a URL in this format:

Field Specifications

Key field(s): BrandId

To fetch details for one Brand using the key field(s), call the endpoint with URL in format: /odata/Brands({BrandId})

You can fetch the Company a Contact works for with a URL in this format:

Field Specifications

Key field(s): CompanyId

To fetch details for one Company using the key field(s), call the endpoint with URL in format: /odata/Companies({CompanyId})