advertisement

APID Identifiers

When Ancestry.com imports a GEDCOM file, it recognizes custom _APID subrecords that supply an APID identifier to link a citation to an entry in an Ancestry.com database. The APID identifier is only understood by Ancestry.com, so you should leave Ancestry APID Location set to "None" if you are not exporting to an Ancestry.com tree.

Finding APIDs

You may use the APID Utilities below to extract APIDs from Ancestry.com URLs.

An APID includes a database number and a record number in the format "database::record", for example, "7602::2771226". Ancestry's web pages do not make those values obvious, but they are usually present in URLs for record pages.

screenshot of browser URL text showing dbid and h attributes, the database and record number for an APID
Ancestry.com URL Showing Database ID ("dbid=") and Record Number ("h=")

In the example URL above, the dbid is the database ID. The h= value is the record number. Those are the usual URL parameters for the database and record number components of the APID. In some cases, and especially for some common databases, the dbid parameter is replaced by a db= parameter, such as db=1900usfedcen. For example:

... sse.dll?db=1900usfedcen ...

You cannot use the value of the db= parameter in an APID; the database number in the APID must be a numeric database ID. To determine the database ID, you can inspect a link to the database that appears at the top of the record display page. As shown in the screenshot below, hover your mouse over the link to the database information page that is under the person's name when viewing a record in the database:

screenshot of mouse hovering over database name to show URL in browser hint
Hovering Over the Database Link to Show the URL

In the screenshot, Firefox shows the URL for the link as a hint near the bottom of the page. Other browsers may show the URL somewhere else, or not at all. If you do not see it, right-click on the database name and select "Copy Link Location". "Copy Link Address", or whatever command your browser uses to copy the URL. Paste the URL into a text editor window (such as Notepad) so you can see the database ID number.

In the screenshot above we see that Ancestry's database ID for the 1900 US Federal Census is 7602.

Entering APIDs in TMG

You may enter the APID in one of several locations in TMG: Citation Detail, Citation Memo, Citation Reference, or a Source element. I recommend using the Citation Reference as that value is not loaded by most GEDCOM readers, and using it to enter a value that identifies a record is a typical use for the Citation Reference field.

screenshot of TMG Edit Citation window showing APID in Citation Reference field
APID in Citation Reference Field

TMG to GEDCOM Configuration

To direct TMG to GEDCOM to search for APID values in TMG citations, use the Ancestry APID Location property in the Sources section. If you enter the APID in the Citation Reference field, set the Ancestry APID Location property to "Citation Reference".

The Ancestry.com templates provided with TMG to GEDCOM have the Ancestry APID Location property set to "Any". If you only use one TMG location for APIDs, such as the Citation Reference field suggested here, change the Ancestry APID Location to specify the location you use. That will reduce the chance that TMG to GEDCOM will misidentify some other value as an APID.

Ancestry.com Results

After uploading a GEDCOM file to Ancestry you will see "Ancestry Sources" in the profile for people who have TMG citations with APID values. Here is a screenshot showing the result:

screenshot of Ancestry person profile showing Immigration event with link to Ancestry database record
Immigration Event Citing Ancestry Record via APID

Clicking an "Ancestry Source" will open a source citation window that includes text fields from the Ancestry.com database record and links to the record, and an image of the record if one is available.

APID Utilities

Use this section of the page to convert APIDs to and from URLs.

APID from URL

Copy/paste an Ancestry.com URL to extract the APID value.

URL from APID

Copy/paste an Ancestry.com APID to create an HREF to the record.

On This Page