Actual group – offres d'emploi

Actual group employment agencies (about 780 in France) in a town or a region, with address and specialties. Candidates can visit or call an agency for advice, registration or follow-up on their applications.

{
  "type": "object",
  "properties": {
    "city": {
      "description": "Town name, e.g. \"Nantes\".",
      "type": "string"
    },
    "region": {
      "description": "French region name, e.g. \"Pays de la Loire\".",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of agencies returned. Defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full details of one Actual group job offer: description, required profile, salary, schedule, benefits and recruiting agency. Takes the slug returned by search_offers (also the last segment of the offer URL).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Offer slug, from search_offers or the offer URL."
    },
    "lang": {
      "description": "Language of the offer text. Defaults to fr.",
      "type": "string",
      "enum": [
        "fr",
        "en"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Exact filter values accepted by search_offers for one dimension (contract type, job family, industry or region), with the number of open offers for each. Optionally scoped by a query and a town.

{
  "type": "object",
  "properties": {
    "dimension": {
      "type": "string",
      "enum": [
        "contractType",
        "family",
        "industry",
        "region"
      ],
      "description": "Which filter to list."
    },
    "q": {
      "description": "Optional free text to scope the counts.",
      "type": "string"
    },
    "town": {
      "description": "Optional town or postal code to scope the counts.",
      "type": "string"
    }
  },
  "required": [
    "dimension"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search the job offers (temporary work, fixed-term and permanent contracts) published by Actual group in France. Combine a free-text query with a town and filters. Filter values for contractType, family, industry and region must be exact French values: get them from list_offer_facets. Use get_offer with a result's slug for the full offer.

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Free text: job title, skill or keyword, e.g. \"cariste\", \"soudeur TIG\", \"aide-soignant\".",
      "type": "string"
    },
    "town": {
      "description": "French town or postal code to search around, e.g. \"Rennes\" or \"35000\".",
      "type": "string"
    },
    "radius": {
      "description": "Search radius in km around the town. Defaults to 20.",
      "anyOf": [
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        },
        {
          "type": "number",
          "const": 50
        }
      ]
    },
    "contractType": {
      "description": "Contract types (exact values from list_offer_facets), e.g. [\"Contrat de travail temporaire\", \"CDI\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "family": {
      "description": "Job families (exact values from list_offer_facets).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "industry": {
      "description": "Industries (exact values from list_offer_facets).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "region": {
      "description": "French regions (exact values from list_offer_facets), e.g. [\"Bretagne\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sort": {
      "description": "Sort order. Defaults to relevance.",
      "type": "string",
      "enum": [
        "relevance",
        "date",
        "distance"
      ]
    },
    "page": {
      "description": "Page number, from 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "pageSize": {
      "description": "Results per page, 1 to 20. Defaults to 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "lang": {
      "description": "Language of the offer texts and URLs. Defaults to fr.",
      "type": "string",
      "enum": [
        "fr",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Prepare an application to an Actual group offer on behalf of the candidate you are assisting. Returns a personal link, valid 72 hours, that the candidate must open to attach their CV and give consent to the processing of their data; the application is only sent once they submit that page. Only call this when the candidate has asked to apply and given you their name and email. Never submit the page yourself: give the link to the candidate.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug of the offer, from search_offers or get_offer."
    },
    "firstName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Candidate first name."
    },
    "lastName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Candidate last name."
    },
    "email": {
      "type": "string",
      "maxLength": 200,
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Candidate email address."
    },
    "phoneNumber": {
      "description": "Candidate phone number, optional.",
      "type": "string",
      "maxLength": 30
    },
    "lang": {
      "description": "Language of the application page. Defaults to fr.",
      "type": "string",
      "enum": [
        "fr",
        "en"
      ]
    }
  },
  "required": [
    "slug",
    "firstName",
    "lastName",
    "email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}