Resolve one or more provider IDs to entities (primary endpoint)

Changed on

The primary bulk translation endpoint. Given a list of (provider, id, type?) items, returns the matching entities. Use this both for single lookups (one-element array) and bulk translation (up to 100 per request).

Translation workflow — to translate N Opta IDs into Wyscout IDs in one call:

POST /batch/resolve
{ "items": [{"provider": "opta", "id": "..."}, ...],
  "targets": ["wyscout"] }

Each result's external_ids will contain only the requested target providers, dramatically reducing payload size. The from field on every result echoes the input so callers can correlate regardless of array order or not_found gaps.

Error handling — malformed items return inline errors (missing_fields, unknown_provider, not_found) rather than failing the whole batch. The response count always equals items.length; position is preserved.

Maximum 100 items per request.

post/batch/resolve

Request

  • Base URL
    https://reep-api.rahulkeerthi2-95d.workers.dev
  • Auth
    none declared

Request body

targetsProviderName[]

Optional filter on response external_ids. When provided, each matched entity's external_ids will contain only the named providers, and the qid convenience field is populated only if wikidata is in the list. Unknown provider names are silently ignored. Useful for trimming response size when you only need one or two target IDs per translation.

Response

Batch resolve results. Position is preserved, count equals items.length.

countinteger

Changes

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • info

      added the new optional request property //

    • info

      removed subschema #1 subschema #2 from the / response property oneOf list for the response status

    • breaking

      request property // was restricted to a list of enum values

    • breaking

      the request property's minItems was increased to 1

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • info

      added the new optional request property

    • info

      added the new 11v11 enum value to the request property //

    • info

      added the new api_football enum value to the request property //

    • info

      added the new besoccer enum value to the request property //

    • info

      added the new capology enum value to the request property //

    • info

      added the new clubelo enum value to the request property //

    • info

      added the new dongqiudi enum value to the request property //

    • info

      added the new espn enum value to the request property //

    • info

      added the new eu_football_info enum value to the request property //

    • info

      added the new fbref enum value to the request property //

    • info

      added the new fbref_verified enum value to the request property //

    • info

      added the new fff_fr enum value to the request property //

    • info

      added the new flashscore enum value to the request property //

    • info

      added the new footballdatabase_eu enum value to the request property //

    • info

      added the new fotmob enum value to the request property //

    • info

      added the new german_fa enum value to the request property //

    • info

      added the new heimspiel enum value to the request property //

    • info

      added the new hugman enum value to the request property //

    • info

      added the new impect enum value to the request property //

    • info

      added the new kicker enum value to the request property //

    • info

      added the new lequipe enum value to the request property //

    • info

      added the new national_football_teams enum value to the request property //

    • info

      added the new opta enum value to the request property //

    • info

      added the new opta_numeric enum value to the request property //

    • info

      added the new optacore enum value to the request property //

    • info

      added the new playmakerstats enum value to the request property //

    • info

      added the new premier_league enum value to the request property //

    • info

      added the new serie_a enum value to the request property //

    • info

      added the new skillcorner enum value to the request property //

    • info

      added the new soccerbase enum value to the request property //

    • info

      added the new soccerdonna enum value to the request property //

    • info

      added the new soccerway enum value to the request property //

    • info

      added the new sofascore enum value to the request property //

    • info

      added the new sofifa enum value to the request property //

    • info

      added the new sportmonks enum value to the request property //

    • info

      added the new statmuse_pl enum value to the request property //

    • info

      added the new thesportsdb enum value to the request property //

    • info

      added the new transfermarkt enum value to the request property //

    • info

      added the new transfermarkt_manager enum value to the request property //

    • info

      added the new uefa enum value to the request property //

    • info

      added the new understat enum value to the request property //

    • info

      added the new whoscored enum value to the request property //

    • info

      added the new wikidata enum value to the request property //

    • info

      added the new worldfootball enum value to the request property //

    • info

      added the new wyscout enum value to the request property //

    • info

      removed subschema #2 from the / response property oneOf list for the response status