Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Bulk People Enrichment

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

Apollo

​

Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.

Apollo Операции

Bulk People Enrichment

​

Enrich up to 10 people in one call. Body takes details, an array of the same identifier objects post_apollo_people_match accepts. Returns matches alongside status, total_requested_enrichments, unique_enriched_records, missing_records and credits_consumed — read missing_records rather than assuming every input matched. Costs one credit per record enriched, not per call. Use this over a loop of single calls: same credits, one round trip. For a single person post_apollo_people_match is simpler. Requires Felo administrative permission.

Query-параметры
  • run_waterfall_email
    Тип: boolean

    Set to true to enable email waterfall enrichment

  • run_waterfall_phone
    Тип: boolean

    Set to true to enable phone waterfall enrichment

  • reveal_personal_emails
    Тип: boolean

    Set to true if you want to enrich all matched people with personal emails. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If a person resides in a GDPR -compliant region, Apollo will not reveal their personal email.

  • reveal_phone_number
    Тип: boolean

    Set to true if you want to enrich the data of all matched people with all available phone numbers, including mobile phone numbers. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If this parameter is set to true, you must enter a webhook URL for the webhook_url parameter. Apollo will asynchronously verify phone numbers for you, then send a JSON response that includes only details about the phone numbers to the webhook URL you provide. It can take several minutes for the phone numbers to be delivered.

  • webhook_url
    Тип: string

    If you set the reveal_phone_number parameter to true, this parameter becomes mandatory. Otherwise, do not use this parameter. Enter the webhook URL that specifies where Apollo should send a JSON response that includes the phone number you requested. Apollo suggests testing this flow to ensure you receive the separate response with the phone number. If phone numbers are not revealed delivered to the webhook URL, try applying UTF-8 encoding to the webhook URL. Example: https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40; https%3A%2F%2Fwebhook.site%2Fcc4cf44e-e047-4774-8dac-473d28474e40

Тело
обязательно
application/json
  • details
    Тип: array object[]
    обязательно

    Provide info for each person you want to enrich as an object within this array. Add up to 10 people.

    One person to enrich. Give whatever identifiers you have — the more, the likelier the match.

    • domain
      Тип: string

      Domain of the person's employer, without www. Example: apollo.io

    • email
      Тип: string

      Email address of the person.

    • first_name
      Тип: string

      First name, used with last_name. Example: tim

    • hashed_email
      Тип: string

      MD5 or SHA-256 hash of the email address.

    • id
      Тип: string

      Apollo person id, e.g. from a people search.

    • last_name
      Тип: string

      Last name, used with first_name. Example: zheng

    • linkedin_url
      Тип: string

      LinkedIn profile URL of the person.

    • name
      Тип: string

      Full name, e.g. "tim zheng"; replaces first_name + last_name.

    • organization_name
      Тип: string

      Name of the person's employer. Example: apollo

Ответы
  • 200
    Тип: object

    Successful response

    • credits_consumed
      Тип: integer

      Response field

    • error_code
      Тип: string

      Response field

    • error_message
      Тип: string

      Response field

    • matches
      Тип: array string[]

      Response array

    • missing_records
      Тип: integer

      Response field

    • status
      Тип: string

      Response field

    • total_requested_enrichments
      Тип: integer

      Response field

    • unique_enriched_records
      Тип: integer

      Response field

    • waterfall
      Тип: object

      Response object

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for post/v1/beta/apollo/people/bulk_match
curl https://openapi.felo.ai/v1/beta/apollo/people/bulk_match \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "details": [
    {
      "first_name": "",
      "last_name": "",
      "name": "",
      "email": "",
      "hashed_email": "",
      "organization_name": "",
      "domain": "",
      "id": "",
      "linkedin_url": ""
    }
  ]
}'

{
  "status": "string",
  "error_code": "string",
  "error_message": "string",
  "total_requested_enrichments": 1,
  "unique_enriched_records": 1,
  "missing_records": 1,
  "credits_consumed": 1,
  "matches": [
    "string"
  ],
  "waterfall": {}
}

Successful response

Bulk People Enrichment